@dialecte/core 0.7.0 → 0.8.0

package/dist/store/engine/wire/wire.types.d.ts

@@ -0,0 +1,119 @@
+import { DialecteError } from '../../../errors';
+/**
+ * A thrown value as a port carries it: a structured error with its record, any other `Error` with its
+ * name, or any other value as it clones (its text when it cannot).
+ */
+export type ThrownData = {
+    kind: 'dialecte';
+    message: string;
+    stack?: string;
+    error: DialecteErrorData;
+} | {
+    kind: 'error';
+    name: string;
+    message: string;
+    stack?: string;
+    cause?: ThrownData;
+} | {
+    kind: 'value';
+    value: unknown;
+};
+/** A structured error's record as a port carries it: its cause as data too. */
+export type DialecteErrorData = Omit<DialecteError, 'cause'> & {
+    cause?: ThrownData;
+};
+/** What a value that would not cross a port as it is stands for: the store's check refuses its stand-in as it. */
+export type WireStandInKind = 'function' | 'symbol' | 'instance' | 'raw-json' | 'to-json' | 'throwing-read' | 'throwing-inspection';
+/**
+ * A value of an argument, at `path` under it, left out of the copy and rebuilt on the other side:
+ * `name` the class of an instance, `text` a raw JSON value's text, `message` what reading or looking
+ * into it threw.
+ */
+export type WireStandIn = {
+    index: number;
+    path: (string | number)[];
+    kind: WireStandInKind;
+    name?: string;
+    text?: string;
+    message?: string;
+};
+/** The values of a call's arguments as a port carries them: plain data, and the stand-ins to rebuild. */
+export type WireValues = {
+    values: unknown[];
+    standIns: WireStandIn[];
+};
+/**
+ * Where the copy is: the argument, the path under it (one stack, copied only into a stand-in), the
+ * containers above (their copies by original), the stand-ins named so far.
+ */
+export type WireCopyStep = {
+    index: number;
+    path: (string | number)[];
+    ancestors: Map<object, unknown>;
+    standIns: WireStandIn[];
+};
+/**
+ * Where an argument of a call holds a value the store's JSON check reads from its root (the depth it
+ * counts starts there): the argument, or the value at a path of keys under it.
+ */
+export type WireJsonPlace = {
+    argument: number;
+    path?: readonly string[];
+};
+/**
+ * How one member of the engine crosses a port. A member marked a read is made again on the next engine:
+ * it carries no progress listener, write id or abort (the type refuses them); that it writes nothing is the
+ * wire table's word, checked by the store's own cases. An abort is only ever made from inside its import
+ * or export, never made again: a `read` flag on one would change nothing.
+ */
+export type WireMemberSpec = WireReadSpec | WireCallSpec;
+/** A member that only reads: refused because its engine ended with its host, it is made once more on the next one. */
+export type WireReadSpec = {
+    read: true;
+    /** The places of its arguments holding values the engine's JSON check reads (copied as plain data). */
+    json?: readonly WireJsonPlace[];
+    listener?: never;
+    identified?: never;
+    abortable?: never;
+};
+/** Any other member: never made again. */
+export type WireCallSpec = {
+    read?: false;
+    /** The place of its progress listener among its arguments (it stays with the caller: its ticks cross as signals). */
+    listener?: number;
+    /** The places of its arguments holding values the engine's JSON check reads (copied as plain data). */
+    json?: readonly WireJsonPlace[];
+    /** It is a write its caller identifies: its first argument carries the `writeId`. */
+    identified?: boolean;
+    /** It is an export the caller can stop: its first argument carries the `exportId`. */
+    abortable?: boolean;
+};
+/** A call of a member of the engine as a port carries it. */
+export type WireRequest = {
+    member: string;
+    args: unknown[];
+    standIns: WireStandIn[];
+    /**
+     * The call's progress listener, by an id of the client's: the engine posts each tick on the client's
+     * port under it (one port: every tick reaches the caller before the answer). None, no tick.
+     */
+    progressId?: number;
+    /**
+     * The connection the call is made for, when the client's port serves several (a page's port to a project through
+     * the hub): the change it makes is told tagged with it. None: the port's own client.
+     */
+    connectionId?: string;
+};
+/** What the engine answers a call: its value, or what it threw as data. */
+export type WireAnswer = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    thrown: ThrownData;
+};
+/** What the engine exposes on a client's port: one member, every call through it. */
+export type EngineWire = {
+    call: (request: WireRequest) => Promise<WireAnswer>;
+};
+//# sourceMappingURL=wire.types.d.ts.map

package/dist/store/engine/wire/wire.types.d.ts.map

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

package/dist/store/hub-public.d.ts

@@ -0,0 +1,33 @@
+import { ConnectHubParams, HubRealm } from './engine/hub/hub-client.types';
+/**
+ * Connect this page to the origin's hub, once, and get its connection (`HubRealm`: `realmId`, `createHubPort` to bind a
+ * child frame, `onRejoined`, the moment to bind child frames again after a freeze or a drop): a second call - from this copy of the library or
+ * another one of the same protocol - gets the same connection. Answers `undefined` where the browser
+ * has no SharedWorker, or the hub never welcomed the page (its script failed to load or was blocked, or
+ * it stayed silent): a later call tries again. A hub of another protocol refuses the page:
+ * `STORE_PROTOCOL_MISMATCH`; the browser refusing to make the hub's worker (a `DOMException`) is no hub,
+ * any other error thrown making it is thrown. The page registers the engines it can start whose worker is of
+ * its own origin (each dialecte's `factory.spawner`); a later call adds those it does not run yet - a project opened on `sqlite` adds its own as it opens - and one naming a dialecte the page runs at another version is
+ * refused `STORE_HUB_SPAWNERS_FIXED`, the connection kept. A document that joined through `adoptHubPort` hosts no
+ * engine: the spawners it names are not registered; neither are those of a page that cannot store (no private file
+ * system; two versions of one dialecte refused all the same): its own projects on `sqlite` are refused
+ * `STORE_UNAVAILABLE` unless its page bound it, its connection serving to hand ports to its children. An engine's
+ * files (the SQLite wasm) are fetched when the page first starts one.
+ *
+ * @intent register this page's dialecte engines with the hub before any project opens, connect a page to the origin's hub, offer a dialecte's engine to the hub (`factory.spawner`), get a port to hand a child frame of another origin
+ */
+export declare function connectHub(params?: ConnectHubParams): Promise<HubRealm | undefined>;
+/**
+ * Join the hub through a port a page made with `createHubPort` (a document that cannot reach the
+ * hub's script), and get that document's connection: a client only, whose liveness is that page's. A port nobody answers fails the join
+ * `STORE_CONNECTION_FAILED` once the welcome budget has passed. A document that connected already gets
+ * its connection - `undefined` when that one found no hub. One the hub dropped with its page (its calls
+ * refused `STORE_ENGINE_LOST`, `realm-dropped`) joins again on the new port, on its own: the page makes
+ * it one from `onRejoined`, and a join that fails leaves it dropped until the next one.
+ *
+ * @intent join the hub from an iframe of another origin, open projects on SQLite storage in a child frame through its page's engine, bind a child frame again after its page rejoined the hub
+ */
+export declare function adoptHubPort(params: {
+    port: MessagePort;
+}): Promise<HubRealm | undefined>;
+//# sourceMappingURL=hub-public.d.ts.map

package/dist/store/hub-public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-public.d.ts","sourceRoot":"","sources":["../../src/store/hub-public.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAG9F;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,UAAU,CAAC,MAAM,GAAE,gBAAqB,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAQ7F;AAYD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAG/F"}

package/dist/store/ignore-destroy-outcome.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A destroy waited for, whatever it answered - refused, or failed: the operation, open or destroy waiting
+ * for it goes on all the same, and meets the store as that destroy left it.
+ */
+export declare function ignoreDestroyOutcome(): void;
+//# sourceMappingURL=ignore-destroy-outcome.d.ts.map

package/dist/store/ignore-destroy-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-destroy-outcome.d.ts","sourceRoot":"","sources":["../../src/store/ignore-destroy-outcome.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAAG"}

package/dist/store/in-memory/in-memory-state.d.ts

@@ -0,0 +1,46 @@
+import { StoreNotice } from '../store.types';
+import { InMemoryChange, InMemoryState } from './types';
+/** The instances of each project (its key) opened and not closed since: a destroy is refused while another one is. */
+export declare const OPEN_IN_MEMORY_CONNECTIONS: import('../open-connections.types').OpenConnections;
+/** The instances of each project (its key) closed while operations of theirs run: a destroy lets those complete first. */
+export declare const CLOSING_IN_MEMORY_CONNECTIONS: import('../closing-connections.types').ClosingConnections;
+/** `listener` of the project (its key) told its changes, as `connection`; answers the unsubscribe. */
+export declare function listenToInMemoryProject(params: {
+    key: string;
+    connection: object;
+    listener: (notice: StoreNotice) => void;
+}): () => void;
+/** A change of the project (its key; `name`, as a failing listener's report names it) told to every instance listening, `own` to the one that made it. */
+export declare function announceInMemoryChange(params: {
+    key: string;
+    name: string;
+    connection: object;
+    change: InMemoryChange;
+}): void;
+/**
+ * Where a project's in-memory state is kept: its dialecte and its name (`projectKeyOf`), or its name alone,
+ * URI-encoded, when no dialecte is told - never a `/` in it, so it never reads as another dialecte's project.
+ */
+export declare function inMemoryStateKeyOf(params: {
+    project: string;
+    dialecteId?: string;
+}): string;
+/** The state of the project (its key), or none when nothing was written under it since it was last destroyed. */
+export declare function findInMemoryState(params: {
+    key: string;
+}): InMemoryState | undefined;
+/** The state of the project (its key), started empty when there is none. */
+export declare function ensureInMemoryState(params: {
+    key: string;
+}): InMemoryState;
+/** Forget the state of the project (its key): every instance of it reads empty until something is written again. */
+export declare function dropInMemoryState(params: {
+    key: string;
+}): void;
+export declare function createInMemoryState(): InMemoryState;
+/** A write landed on the document: its version moves on (in the write's synchronous section, so an export reading it sees the write). */
+export declare function bumpVersion(params: {
+    state: InMemoryState;
+    documentId: string;
+}): void;
+//# sourceMappingURL=in-memory-state.d.ts.map

package/dist/store/in-memory/in-memory-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-state.d.ts","sourceRoot":"","sources":["../../../src/store/in-memory/in-memory-state.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAoB,aAAa,EAAE,MAAM,SAAS,CAAA;AAU9E,sHAAsH;AACtH,eAAO,MAAM,0BAA0B,qDAA0B,CAAA;AAEjE,0HAA0H;AAC1H,eAAO,MAAM,6BAA6B,2DAA6B,CAAA;AAKvE,sGAAsG;AACtG,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;CACvC,GAAG,MAAM,IAAI,CAUb;AAED,0JAA0J;AAC1J,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,cAAc,CAAA;CACtB,GAAG,IAAI,CAUP;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAK3F;AAED,iHAAiH;AACjH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,GAAG,SAAS,CAEpF;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAO1E;AAED,oHAAoH;AACpH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAE/D;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAYnD;AAED,yIAAyI;AACzI,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGtF"}

package/dist/store/in-memory/in-memory-store.constants.d.ts

@@ -0,0 +1,7 @@
+import { ReadonlyInMemoryState } from './types';
+import { AnyRawRecord } from '../../types';
+/** What a document that is not in the store reads as: no records. */
+export declare const EMPTY_TABLE: ReadonlyMap<string, AnyRawRecord>;
+/** What a name with no state reads as, and all a placeholder store ever reads: nothing. */
+export declare const EMPTY_STATE: ReadonlyInMemoryState;
+//# sourceMappingURL=in-memory-store.constants.d.ts.map

package/dist/store/in-memory/in-memory-store.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.constants.d.ts","sourceRoot":"","sources":["../../../src/store/in-memory/in-memory-store.constants.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,qEAAqE;AACrE,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAa,CAAA;AAEvE,2FAA2F;AAC3F,eAAO,MAAM,WAAW,EAAE,qBAA6C,CAAA"}

package/dist/store/in-memory/in-memory-store.d.ts

@@ -1,6 +1,6 @@
-import { Store, ChangeLogEntry } from '../store.types';
+import { Store, ChangeLogEntry, ExportFileParams, ExportFileResult, ImportFileParams, ImportFileResult, StoreNotice, WriteOutcome } from '../store.types';
 import { InMemoryStoreOptions } from './types';
-import { DocumentRecord } from '../../project/types';
+import { DocumentRecord, DocumentUpdates } from '../../project/types';
 import { AnyRawRecord, BlobAttachment, BlobRecord, RecordPatch } from '../../types';
 /**
  * InMemoryStore - Map-backed Store implementation with no persistence.
@@ -10,27 +10,54 @@ import { AnyRawRecord, BlobAttachment, BlobRecord, RecordPatch } from '../../typ
  * - Test fixtures (writable: true)
  * - Demos and playground (writable: true)
  *
- * When writable is false, any mutation throws STORE_NOT_WRITABLE.
- * Reads always return empty results.
+ * Every instance of a project - its dialecte and name, or its name alone when no `dialecteId` is given -
+ * reads and writes one state, as every connection to a SQLite project does: a store closed and built
+ * again for its project finds what was written. `close` keeps it; `destroy` drops it. The state is the realm's (and the loaded copy of core's): nothing crosses
+ * realms.
+ *
+ * Records are values: the store copies what it is handed and what it hands out, so a caller changing
+ * its objects never changes the store, as with a store whose records cross a serialisation. Blob data
+ * is immutable and is not copied. List reads answer in id order, as an IndexedDB key range does.
+ *
+ * When writable is false, the store is a placeholder: any mutation throws STORE_NOT_WRITABLE, reads
+ * answer empty, and it never reads, keeps or drops the state of its project.
+ *
+ * Its imports run in its own realm, the page's: `importFile` runs `runImport` with the import
+ * runtime it was built with.
  */
 export declare class InMemoryStore implements Store {
     readonly name: string;
     private readonly writable;
+    private readonly runtime?;
+    /** Which state of the realm this store reads and writes: its dialecte and its name, or its name alone. */
+    private readonly stateKey;
     /** Guard so the cross-realm no-op warning is emitted at most once per session. */
     private static reconcileWarned;
-    private documents;
-    private records;
-    private changelog;
-    private heads;
-    private blobs;
-    private blobData;
+    /** Set by `close()`, cleared by `open()`: a closed store refuses every operation started after it. */
+    private closed;
+    /** How many times `close()` was called: an `open()` refuses when one came after it was called. */
+    private closings;
+    /** The imports this instance runs (its only operations that span awaits): `open()` and `destroy()` wait for them. */
+    private readonly operations;
+    /** This store's own destroy while it runs: an operation started meanwhile goes on once it has ended. */
+    private destroying;
     constructor(name: string, options?: InMemoryStoreOptions);
+    /** Open: an import found unfinished - it never outlives the store - is removed; one it runs stays. */
     open(): Promise<void>;
-    close(): void;
+    /**
+     * Refuse every operation started from now on until opened again; one running completes (only an
+     * import spans more than a call), and the close is settled once it has. The project's state stays.
+     */
+    close(): Promise<void>;
+    /**
+     * Drop the project's state, for every instance of it; refused `PROJECT_OPEN_ELSEWHERE` while another
+     * instance of the project is open. A placeholder has none to drop.
+     */
     destroy(): Promise<void>;
+    private destroyOnceIdle;
     /**
-     * No-op: in-memory data is not shared across realms/tabs, so there is nothing
-     * to reconcile. Warns once to flag that a cross-realm setup (e.g. iframe
+     * No-op: in-memory data is the realm's (one state per project there), not shared across realms/tabs, so
+     * there is nothing to reconcile. Warns once to flag that a cross-realm setup (e.g. iframe
      * extensions) will not see documents imported in another realm with this store.
      */
     reconcile(): Promise<void>;
@@ -39,13 +66,18 @@ export declare class InMemoryStore implements Store {
     registerDocument(file: DocumentRecord): Promise<void>;
     getDocument(documentId: string): Promise<DocumentRecord | undefined>;
     getDocuments(): Promise<DocumentRecord[]>;
-    updateDocument(documentId: string, updates: Partial<Pick<DocumentRecord, 'name' | 'metadata' | 'status' | 'importingAt'>>): Promise<void>;
+    updateDocument(documentId: string, updates: DocumentUpdates): Promise<void>;
     removeDocument(documentId: string): Promise<void>;
-    get(id: string, documentId?: string): Promise<AnyRawRecord | undefined>;
+    get(id: string, documentId: string): Promise<AnyRawRecord | undefined>;
     getByDocumentId(documentId: string): Promise<AnyRawRecord[]>;
     count(documentId: string): Promise<number>;
     getByTagNameInDocument(tagName: string, documentId: string): Promise<AnyRawRecord[]>;
     getMany(ids: string[], documentId: string): Promise<(AnyRawRecord | undefined)[]>;
+    importFile(params: ImportFileParams): Promise<ImportFileResult>;
+    exportFile(params: ExportFileParams): Promise<ExportFileResult>;
+    getWriteOutcome(params: {
+        writeId: string;
+    }): Promise<WriteOutcome>;
     bulkWrite(documentId: string, ops: {
         creates?: AnyRawRecord[];
         updates?: RecordPatch[];
@@ -53,11 +85,13 @@ export declare class InMemoryStore implements Store {
     }): Promise<void>;
     commit(params: {
         documentId: string;
+        writeId?: string;
         creates: AnyRawRecord[];
         updates: AnyRawRecord[];
         deletes: string[];
         onProgress: (current: number, total: number) => void;
     }): Promise<void>;
+    /** Undo the last applied entry, its parts in reverse: the deleted records back, the befores, the creates gone. */
     undo(documentId: string): Promise<void>;
     redo(documentId: string): Promise<void>;
     getHistoryStatus(documentId: string): Promise<{
@@ -80,8 +114,62 @@ export declare class InMemoryStore implements Store {
         recordRef: string;
     }): Promise<void>;
     removeBlob(blobId: string): Promise<void>;
-    private getBlobTable;
-    private getTable;
+    /**
+     * Every change of the project made through any in-memory store of it in this page, this store's own told `own`,
+     * before the call that made it settles; a call that changed nothing tells nothing. A placeholder (not writable)
+     * shares no state: it is told nothing.
+     */
+    subscribe(listener: (notice: StoreNotice) => void): () => void;
+    /** A change this store made, told to every store of the project listening. */
+    private announce;
+    private registerDocumentUnguarded;
+    private getDocumentUnguarded;
+    private updateDocumentUnguarded;
+    /** An imported document ready: refused `DOCUMENT_NOT_REGISTERED` once it is no longer the import's own, `importing`. */
+    private markReadyUnguarded;
+    /** An import's records, into its own document only: refused `DOCUMENT_NOT_REGISTERED` once it is not. */
+    private bulkWriteOwnImport;
+    /** What a failed import leaves goes: its own document only, never one registered since under its id. */
+    private removeOwnImport;
+    private removeDocumentUnguarded;
+    private bulkWriteUnguarded;
+    /**
+     * The project's state to read, resolved on every operation: empty when it has none, and always
+     * for a placeholder. Read-only: a write goes through `writeState`.
+     */
+    private readState;
+    /** The project's state to write, resolved on every operation; none when nothing is held for it. */
+    private writeState;
+    /** The records of a document; a document that is not in the store reads empty. */
+    private readTable;
+    /**
+     * The state and the records of a document to write, both of one resolution; a document that is not
+     * registered takes no write.
+     */
+    private writeTarget;
+    /**
+     * Refused once closed; else the store counts open - again after its own destroy, as a SQLite store
+     * connects again on its next operation (a placeholder never does). One started while this store's
+     * own destroy runs goes on once it has ended: it keeps that destroy from nothing.
+     */
+    private guardOpen;
+    /** Guarded once this store's own destroy has ended: closed meanwhile, refused, as one started after the close is. */
+    private guardOpenAfterOwnDestroy;
+    /**
+     * The target the store's own import writes through: the import is one operation, so a `close()`
+     * after it started does not refuse the calls it makes.
+     */
+    private ownImportTarget;
+    /**
+     * The source the store's own export reads through: the export is one operation, so a `close()` after it
+     * started does not refuse the calls it makes.
+     */
+    private ownExportSource;
+    /** How many writes a `ready` document has taken; `undefined` for one not registered or not ready. */
+    private getExportVersion;
+    private countUnguarded;
+    private getByTagNameInDocumentUnguarded;
+    private getManyUnguarded;
     private guardWritable;
 }
 //# sourceMappingURL=in-memory-store.d.ts.map

package/dist/store/in-memory/in-memory-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory-store.d.ts","sourceRoot":"","sources":["../../../src/store/in-memory/in-memory-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEpF;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,YAAW,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,kFAAkF;IAClF,OAAO,CAAC,MAAM,CAAC,eAAe,CAAQ;IAEtC,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,OAAO,CAA+C;IAC9D,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,QAAQ,CAAuC;gBAE3C,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAOlD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,KAAK,IAAI,IAAI;IAEP,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAUhC,4EAA4E;IACtE,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMxD,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAIpE,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIzC,cAAc,CACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC,CAAC,GACpF,OAAO,CAAC,IAAI,CAAC;IAQV,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAWvE,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI5D,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1C,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQpF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,YAAY,GAAG,SAAS,CAAC,EAAE,CAAC;IAOjF,SAAS,CACd,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE;QAAE,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC5E,OAAO,CAAC,IAAI,CAAC;IAsDV,MAAM,CAAC,MAAM,EAAE;QACpB,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,YAAY,EAAE,CAAA;QACvB,OAAO,EAAE,YAAY,EAAE,CAAA;QACvB,OAAO,EAAE,MAAM,EAAE,CAAA;QACjB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KACpD,GAAG,OAAO,CAAC,IAAI,CAAC;IA0DX,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBvC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBvC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IASrF,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAIjE,mBAAmB,IAAI,OAAO;IAMxB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,GAAG,SAAS,CAAC;IAQ/E,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAM7D,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAM9E,kBAAkB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAI3C,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,aAAa;CAOrB"}
+{"version":3,"file":"in-memory-store.d.ts","sourceRoot":"","sources":["../../../src/store/in-memory/in-memory-store.ts"],"names":[],"mappings":"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"}

package/dist/store/in-memory/types.d.ts

@@ -1,5 +1,59 @@
+import { DistributiveOmit } from '../engine/engine.types';
+import { ChangeLogEntry, StoreNotice } from '../store.types';
+import { StoreRuntime } from '../../project/io/store-runtime.types';
+import { DocumentRecord, ProjectChannelMessage } from '../../project/types';
+import { AnyRawRecord, BlobRecord } from '../../types';
 export type InMemoryStoreOptions = {
-    /** When false, mutations throw STORE_NOT_WRITABLE. Default: true */
+    /**
+     * When false, the store is a placeholder: mutations throw STORE_NOT_WRITABLE, reads answer empty,
+     * and it never reads, keeps or removes the state of its project. Default: true
+     */
     writable?: boolean;
+    /**
+     * The dialecte the store imports and exports files with; without it, `importFile` throws `IMPORT_FAILED`
+     * and `exportFile` `ASSERTION_FAILED`
+     */
+    runtime?: StoreRuntime;
+    /**
+     * The dialecte of the project: with the name, which state the store reads and writes - two dialectes' projects
+     * of one name are two projects, as on every store that keeps them. Without it, the name alone.
+     */
+    dialecteId?: string;
 };
+/** What the in-memory stores of one project hold, the same for each instance of that project in a realm. */
+export type InMemoryState = {
+    documents: Map<string, DocumentRecord>;
+    /** The records of each document, by record table name. */
+    records: Map<string, Map<string, AnyRawRecord>>;
+    changelog: Map<string, ChangeLogEntry[]>;
+    /** The sequence number of each document's last applied changelog entry. */
+    heads: Map<string, number>;
+    /** The ids of the commits each document's undone entries carried when a later commit discarded them. */
+    discardedCommits: Map<string, Set<string>>;
+    blobs: Map<string, BlobRecord>;
+    blobData: Map<string, Map<string, Blob>>;
+    /** The `writeId`s of the imports running on a store of this project: an `open` keeps their documents. */
+    runningImports: Set<string>;
+    /** How many writes each document has taken (bulk writes, commits, undos, redos): what an export checks. */
+    versions: Map<string, number>;
+};
+/** A state as read: what a project with no state reads as, and all a placeholder store reads. */
+export type ReadonlyInMemoryState = {
+    documents: ReadonlyMap<string, DocumentRecord>;
+    records: ReadonlyMap<string, ReadonlyMap<string, AnyRawRecord>>;
+    changelog: ReadonlyMap<string, readonly ChangeLogEntry[]>;
+    heads: ReadonlyMap<string, number>;
+    discardedCommits: ReadonlyMap<string, ReadonlySet<string>>;
+    blobs: ReadonlyMap<string, BlobRecord>;
+    blobData: ReadonlyMap<string, ReadonlyMap<string, Blob>>;
+    runningImports: ReadonlySet<string>;
+    versions: ReadonlyMap<string, number>;
+};
+/** A connection of an in-memory project listening to its changes: the store it is, and its listener. */
+export type InMemoryListener = {
+    connection: object;
+    listener: (notice: StoreNotice) => void;
+};
+/** A project event as an in-memory store announces it, its timestamp added when told. */
+export type InMemoryChange = DistributiveOmit<ProjectChannelMessage, 'timestamp'>;
 //# sourceMappingURL=types.d.ts.map

package/dist/store/in-memory/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/store/in-memory/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IAClC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/store/in-memory/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvD,MAAM,MAAM,oBAAoB,GAAG;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,4GAA4G;AAC5G,MAAM,MAAM,aAAa,GAAG;IAC3B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACtC,0DAA0D;IAC1D,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IAC/C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;IACxC,2EAA2E;IAC3E,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1B,wGAAwG;IACxG,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAC1C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;IACxC,yGAAyG;IACzG,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC3B,2GAA2G;IAC3G,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7B,CAAA;AAED,iGAAiG;AACjG,MAAM,MAAM,qBAAqB,GAAG;IACnC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC9C,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IAC/D,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC,CAAA;IACzD,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;IAC1D,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACtC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;IACxD,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACnC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC,CAAA;AAED,wGAAwG;AACxG,MAAM,MAAM,gBAAgB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;CAAE,CAAA;AAE9F,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAA"}

package/dist/store/index.d.ts

@@ -1,5 +1,11 @@
-export type { Store, ChangeLogEntry, ChangeLogMeta, RecordSchema } from './store.types';
+export type { Store, ChangeLogEntry, ChangeLogMeta, RecordSchema, ExportControl, ExportFileOptions, ExportFileParams, ExportFileResult, ExportProgress, ExportSource, ImportControl, ImportFileOptions, ImportFileParams, ImportFileResult, ImportPhase, ImportProgress, ImportTarget, StoreChange, StoreNotice, StoreResync, WriteOutcome, } from './store.types';
+export { importOutcomeOf, writeOutcomeOf } from './write-outcome';
+export { applyDocumentUpdates, assertDocumentPlace, parseDocumentPath, pathHolderOf, } from './document-path';
+export type { DocumentPathParts, PathHolderCandidate } from './document-path.types';
+export { DOCUMENT_PATH_INVISIBLE_CHARACTER, DOCUMENT_PATH_MAX_BYTES, DOCUMENT_PATH_SEGMENT_MAX_BYTES, DOCUMENT_PATH_SEPARATOR, DOCUMENT_UPDATE_FIELDS, } from './document-path.constants';
+export { removeUnfinishedImports } from './unfinished-imports';
+export type { HubEngineSpawner } from './engine/hub/realm-host.types';
 export * from './local';
 export * from './in-memory';
-export { TABLE_DOCUMENTS, TABLE_CHANGELOG, TABLE_META, TABLE_RECORD_PREFIX, recordTableName, TABLE_BLOBS, TABLE_BLOB_PREFIX, blobTableName, DOCUMENTS_SCHEMA, CHANGELOG_SCHEMA, META_SCHEMA, BLOBS_SCHEMA, BLOB_DATA_SCHEMA, } from './store.constants';
+export { TABLE_DOCUMENTS, TABLE_CHANGELOG, TABLE_META, TABLE_RECORD_PREFIX, recordTableName, TABLE_BLOBS, TABLE_BLOB_PREFIX, blobTableName, DOCUMENTS_SCHEMA, CHANGELOG_SCHEMA, META_SCHEMA, BLOBS_SCHEMA, BLOB_DATA_SCHEMA, EXPORT_BATCH_SIZE, } from './store.constants';
 //# sourceMappingURL=index.d.ts.map

package/dist/store/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACvF,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,OAAO,EACN,eAAe,EACf,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,gBAAgB,GAChB,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,KAAK,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,GACZ,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EACN,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,GACZ,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AACnF,OAAO,EACN,iCAAiC,EACjC,uBAAuB,EACvB,+BAA+B,EAC/B,uBAAuB,EACvB,sBAAsB,GACtB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AACrE,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,OAAO,EACN,eAAe,EACf,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,mBAAmB,CAAA"}

package/dist/store/json-values.constants.d.ts

@@ -0,0 +1,18 @@
+/** How a refusal names a value of a type JSON has no form for. */
+export declare const REFUSED_TYPES: Readonly<Record<'bigint' | 'function' | 'symbol', string>>;
+/**
+ * The most arrays and objects a value handed to a store may nest, one in the other: well under
+ * SQLite's JSON reader (1,000 levels, the row payload's own two included) and every engine's stack,
+ * so every store refuses a deeper value alike, before anything is written.
+ */
+export declare const JSON_MAX_DEPTH = 512;
+/**
+ * What a text holding a lone surrogate is not, in every refusal that names one (a stored value, a key,
+ * a path).
+ */
+export declare const NOT_WELL_FORMED_TEXT = "not well-formed UTF-16 (a lone surrogate)";
+/** How the walk names a string value that is not well-formed. */
+export declare const NOT_WELL_FORMED_VALUE_KIND = "text that is not well-formed UTF-16 (a lone surrogate)";
+/** How the walk names an object key that is not well-formed (the key itself is not printed). */
+export declare const NOT_WELL_FORMED_KEY_KIND = "a key that is not well-formed UTF-16 (a lone surrogate)";
+//# sourceMappingURL=json-values.constants.d.ts.map

package/dist/store/json-values.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-values.constants.d.ts","sourceRoot":"","sources":["../../src/store/json-values.constants.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,GAAG,UAAU,GAAG,QAAQ,EAAE,MAAM,CAAC,CAIpF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,MAAM,CAAA;AAEjC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,8CAA8C,CAAA;AAE/E,iEAAiE;AACjE,eAAO,MAAM,0BAA0B,2DAAyC,CAAA;AAEhF,gGAAgG;AAChG,eAAO,MAAM,wBAAwB,4DAA0C,CAAA"}

package/dist/store/json-values.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Check a value a write hands the store. A store keeps plain JSON values only: well-formed strings,
+ * finite numbers, booleans, null, and arrays and plain objects of them under well-formed keys, nested
+ * at most `JSON_MAX_DEPTH` levels counted from `value` (every store hands the same: a write's list of
+ * records or patches, or the document). A field holding `undefined` is dropped, as JSON drops a symbol
+ * key and a property that is not enumerable; any other value - text or a key holding a lone surrogate
+ * (SQLite would read it back changed), a Date, a Map, a Set, NaN or Infinity, a BigInt, a function, a
+ * symbol, an instance of a class, a raw JSON value, an object with a `toJSON` method (never called),
+ * `undefined` in an array, a cycle, a value nested deeper - refuses the write with
+ * `STORE_VALUE_NOT_JSON`, before anything is written. One walk, keys in the order JSON gives them,
+ * each value read once: a value must read the same each time (a getter answering something else at
+ * each read is checked as it read first).
+ */
+export declare function checkJsonValues(params: {
+    value: unknown;
+}): void;
+/**
+ * Check the id a commit is written under: kept on its history entry, it is well-formed text, as every
+ * text a store keeps (`STORE_VALUE_NOT_JSON`, field `writeId`).
+ */
+export declare function checkWriteId(params: {
+    writeId: string;
+}): void;
+/**
+ * The store's own copy of a value a write hands it, checked as `checkJsonValues` checks it: what
+ * `JSON.parse` would make of its JSON text, built without the text (`undefined` stays `undefined`).
+ */
+export declare function toJsonCopy<GenericValue>(params: {
+    value: GenericValue;
+}): GenericValue;
+/**
+ * The prototype of an object of no class of its own: `Object.prototype` (or none) for a plain
+ * object, `Array.prototype` for a plain array, of this realm or of another one - known by its own
+ * constructor's name, so a contrived prototype carrying a constructor named `Object` passes.
+ */
+export declare function isRootPrototype(params: {
+    prototype: unknown;
+    name: 'Object' | 'Array';
+}): boolean;
+//# sourceMappingURL=json-values.d.ts.map

package/dist/store/json-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-values.d.ts","sourceRoot":"","sources":["../../src/store/json-values.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAMhE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAE9D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG,YAAY,CAMtF;AAiKD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,GAAG,OAAO,CASjG"}

package/dist/store/json-values.types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A value the JSON walk meets: the key or index holding it (`''` at the root), whether an array
+ * holds it, and the objects and arrays it is held under (a cycle is one of them met again).
+ */
+export type JsonWalkStep = {
+    value: unknown;
+    field: string | number;
+    inArray: boolean;
+    ancestors: object[];
+};
+/** What a value is to the walk once it is known to be JSON: kept as it is, or walked into. */
+export type JsonKind = 'leaf' | 'array' | 'object';
+/** `JSON` with its raw-JSON members, which the TypeScript library does not declare yet. */
+export type JsonWithRawJson = typeof JSON & {
+    rawJSON?: (text: string) => object;
+    isRawJSON?: (value: unknown) => boolean;
+};
+//# sourceMappingURL=json-values.types.d.ts.map

package/dist/store/json-values.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-values.types.d.ts","sourceRoot":"","sources":["../../src/store/json-values.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,EAAE,CAAA;CACnB,CAAA;AAED,8FAA8F;AAC9F,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;AAElD,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GAAG,OAAO,IAAI,GAAG;IAC3C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;CACvC,CAAA"}