@bendyline/docblocks 2.0.0 → 2.1.0

package/dist/document/recovery-journal.js

@@ -1,385 +0,0 @@
-/**
- * Synchronous crash-recovery journal for dirty document snapshots.
- *
- * The journal deliberately depends on a tiny injected Storage-like contract
- * instead of reading `window.localStorage` at module load time. This keeps the
- * document package usable in Node, Electron main, VS Code extension hosts, and
- * tests while allowing browser renderers to use localStorage for a best-effort
- * write that completes before the current JavaScript turn ends.
- */
-export const DOCUMENT_RECOVERY_JOURNAL_STORAGE_KEY = 'docblocks:document-recovery:v1';
-export const DOCUMENT_RECOVERY_JOURNAL_SCHEMA_VERSION = 1;
-const DEFAULT_MAX_ENTRIES = 20;
-const DEFAULT_MAX_STORAGE_BYTES = 2000000;
-const DEFAULT_MAX_RECORD_BYTES = 1000000;
-const DEFAULT_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000;
-const DEFAULT_MAX_FUTURE_SKEW_MS = 5 * 60 * 1000;
-const MAX_TARGET_KEY_LENGTH = 4096;
-/**
- * Best-effort, synchronous recovery storage.
- *
- * Normal save acknowledgement is the only automatic path that removes the
- * current record. Explicit discard, age expiry, corruption repair, and bounded
- * eviction are intentional exceptions: callers can discard after the user
- * rejects recovery, and the journal must never grow without limit.
- */
-export class DocumentRecoveryJournal {
-    constructor(storage, options = {}) {
-        this.storage = storage;
-        this.storageKey = options.storageKey?.trim() || DOCUMENT_RECOVERY_JOURNAL_STORAGE_KEY;
-        this.maxEntries = positiveInteger(options.maxEntries, DEFAULT_MAX_ENTRIES);
-        this.maxStorageBytes = positiveInteger(options.maxStorageBytes, DEFAULT_MAX_STORAGE_BYTES);
-        this.maxRecordBytes = Math.min(positiveInteger(options.maxRecordBytes, DEFAULT_MAX_RECORD_BYTES), this.maxStorageBytes);
-        this.maxAgeMs = nonNegativeFinite(options.maxAgeMs, DEFAULT_MAX_AGE_MS);
-        this.maxFutureSkewMs = nonNegativeFinite(options.maxFutureSkewMs, DEFAULT_MAX_FUTURE_SKEW_MS);
-        this.now = options.now ?? Date.now;
-    }
-    /**
-     * Synchronously persist the latest dirty snapshot for a target.
-     * Storage/quota failures are returned, never thrown into an editor onChange.
-     */
-    write(input) {
-        const timestamp = this.now();
-        if (!isValidWrite(input) || !Number.isFinite(timestamp) || timestamp < 0) {
-            return { status: 'rejected', reason: 'invalid-record', evicted: 0 };
-        }
-        if (!this.storage) {
-            return { status: 'rejected', reason: 'storage-unavailable', evicted: 0 };
-        }
-        if (estimatedBytes(input.content) > this.maxRecordBytes ||
-            (input.persistedContent !== null &&
-                estimatedBytes(input.persistedContent) > this.maxRecordBytes)) {
-            return { status: 'rejected', reason: 'record-too-large', evicted: 0 };
-        }
-        const loaded = this.load(timestamp);
-        const existing = loaded.records.find((record) => record.targetKey === input.targetKey);
-        if (existing) {
-            const ordering = compareGenerationRevision(input, existing);
-            if (ordering < 0)
-                return { status: 'ignored-stale', evicted: 0 };
-            if (ordering === 0) {
-                if (existing.content === input.content &&
-                    existing.persistedContent === input.persistedContent) {
-                    return { status: 'unchanged', evicted: 0 };
-                }
-                // A revision is an immutable content snapshot. Reusing it for different
-                // content would make acknowledgement and recovery ambiguous.
-                return { status: 'rejected', reason: 'invalid-record', evicted: 0 };
-            }
-        }
-        const candidate = {
-            targetKey: input.targetKey,
-            generation: input.generation,
-            revision: input.revision,
-            content: input.content,
-            persistedContent: input.persistedContent,
-            createdAt: existing?.createdAt ?? timestamp,
-            updatedAt: timestamp,
-        };
-        if (estimatedBytes(JSON.stringify(candidate)) > this.maxRecordBytes) {
-            return { status: 'rejected', reason: 'record-too-large', evicted: 0 };
-        }
-        if (estimatedBytes(serializeEnvelope([candidate])) > this.maxStorageBytes) {
-            return { status: 'rejected', reason: 'record-too-large', evicted: 0 };
-        }
-        const next = loaded.records.filter((record) => record.targetKey !== input.targetKey);
-        next.push(candidate);
-        const persisted = this.persistBounded(next, input.targetKey);
-        if (!persisted.stored) {
-            return {
-                status: 'rejected',
-                reason: persisted.reason ?? 'quota-exceeded',
-                evicted: persisted.evicted,
-            };
-        }
-        return { status: 'stored', evicted: persisted.evicted };
-    }
-    /** Return the recoverable snapshot for one target, if present and valid. */
-    lookup(targetKey, generation) {
-        if (!isValidTargetKey(targetKey) || !isOptionalGeneration(generation))
-            return null;
-        const record = this.load(this.now()).records.find((candidate) => candidate.targetKey === targetKey &&
-            (generation === undefined || candidate.generation === generation));
-        return record ? cloneRecord(record) : null;
-    }
-    /** List valid records, newest first. Optionally restrict to one target. */
-    list(targetKey) {
-        if (targetKey !== undefined && !isValidTargetKey(targetKey))
-            return [];
-        return this.load(this.now())
-            .records.filter((record) => targetKey === undefined || record.targetKey === targetKey)
-            .sort(compareNewestFirst)
-            .map(cloneRecord);
-    }
-    /**
-     * Clear a record only when the same generation has durably acknowledged at
-     * least the journaled revision. A stale acknowledgement cannot erase a newer
-     * crash-recovery snapshot.
-     */
-    acknowledge(input) {
-        if (!isValidAcknowledgement(input) || !this.storage)
-            return false;
-        const records = this.load(this.now()).records;
-        const record = records.find((candidate) => candidate.targetKey === input.targetKey);
-        if (!record ||
-            record.generation !== input.generation ||
-            record.revision > input.persistedRevision) {
-            return false;
-        }
-        return this.persistExact(records.filter((candidate) => candidate !== record));
-    }
-    /** Explicitly discard recovery data after a user or lifecycle decision. */
-    discard(targetKey, generation) {
-        if (!isValidTargetKey(targetKey) || !isOptionalGeneration(generation) || !this.storage) {
-            return false;
-        }
-        const records = this.load(this.now()).records;
-        const next = records.filter((record) => record.targetKey !== targetKey ||
-            (generation !== undefined && record.generation !== generation));
-        if (next.length === records.length)
-            return false;
-        return this.persistExact(next);
-    }
-    load(timestamp) {
-        if (!this.storage)
-            return { records: [], needsRepair: false };
-        let raw;
-        try {
-            raw = this.storage.getItem(this.storageKey);
-        }
-        catch {
-            return { records: [], needsRepair: false };
-        }
-        if (raw === null)
-            return { records: [], needsRepair: false };
-        let parsed;
-        try {
-            parsed = JSON.parse(raw);
-        }
-        catch {
-            this.tryRemove();
-            return { records: [], needsRepair: true };
-        }
-        if (!isEnvelope(parsed)) {
-            this.tryRemove();
-            return { records: [], needsRepair: true };
-        }
-        const byTarget = new Map();
-        let needsRepair = estimatedBytes(raw) > this.maxStorageBytes;
-        for (const candidate of parsed.records) {
-            if (!isValidStoredRecord(candidate, timestamp, this.maxAgeMs, this.maxFutureSkewMs)) {
-                needsRepair = true;
-                continue;
-            }
-            if (estimatedBytes(JSON.stringify(candidate)) > this.maxRecordBytes) {
-                needsRepair = true;
-                continue;
-            }
-            const current = byTarget.get(candidate.targetKey);
-            if (!current || compareStoredRecords(candidate, current) > 0) {
-                if (current)
-                    needsRepair = true;
-                byTarget.set(candidate.targetKey, cloneRecord(candidate));
-            }
-            else {
-                needsRepair = true;
-            }
-        }
-        const records = [...byTarget.values()].sort(compareNewestFirst);
-        while (records.length > this.maxEntries) {
-            records.pop();
-            needsRepair = true;
-        }
-        while (records.length > 0 &&
-            estimatedBytes(serializeEnvelope(records)) > this.maxStorageBytes) {
-            records.pop();
-            needsRepair = true;
-        }
-        if (needsRepair) {
-            // Best effort only. Read APIs must still return the validated in-memory
-            // records even when storage is temporarily unavailable.
-            this.persistBounded(records);
-        }
-        return { records, needsRepair };
-    }
-    persistBounded(records, protectedTarget) {
-        if (!this.storage) {
-            return { stored: false, evicted: 0, reason: 'storage-unavailable' };
-        }
-        const next = [...records].sort(compareNewestFirst);
-        let evicted = 0;
-        while (next.length > this.maxEntries) {
-            if (!evictOldest(next, protectedTarget))
-                break;
-            evicted += 1;
-        }
-        let serialized = serializeEnvelope(next);
-        while (estimatedBytes(serialized) > this.maxStorageBytes) {
-            if (!evictOldest(next, protectedTarget)) {
-                return { stored: false, evicted, reason: 'quota-exceeded' };
-            }
-            evicted += 1;
-            serialized = serializeEnvelope(next);
-        }
-        for (;;) {
-            try {
-                this.storage.setItem(this.storageKey, serialized);
-                return { stored: true, evicted };
-            }
-            catch {
-                if (!evictOldest(next, protectedTarget)) {
-                    return { stored: false, evicted, reason: 'quota-exceeded' };
-                }
-                evicted += 1;
-                serialized = serializeEnvelope(next);
-            }
-        }
-    }
-    persistExact(records) {
-        if (!this.storage)
-            return false;
-        if (records.length === 0) {
-            try {
-                this.storage.removeItem(this.storageKey);
-                return true;
-            }
-            catch {
-                return false;
-            }
-        }
-        try {
-            this.storage.setItem(this.storageKey, serializeEnvelope(records));
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    tryRemove() {
-        try {
-            this.storage?.removeItem(this.storageKey);
-        }
-        catch {
-            // Recovery is best effort; a denied cleanup must not fail application startup.
-        }
-    }
-}
-/**
- * Resolve browser localStorage on demand. Importing this module never touches
- * browser globals, and access errors (sandboxing/security settings) yield null.
- */
-export function getDefaultDocumentRecoveryStorage() {
-    try {
-        const candidate = Reflect.get(globalThis, 'localStorage');
-        if (!isStorage(candidate))
-            return null;
-        return candidate;
-    }
-    catch {
-        return null;
-    }
-}
-function serializeEnvelope(records) {
-    const envelope = {
-        schemaVersion: DOCUMENT_RECOVERY_JOURNAL_SCHEMA_VERSION,
-        records,
-    };
-    return JSON.stringify(envelope);
-}
-/** localStorage quotas are commonly measured from UTF-16 storage usage. */
-function estimatedBytes(value) {
-    return value.length * 2;
-}
-function positiveInteger(value, fallback) {
-    return Number.isSafeInteger(value) && (value ?? 0) > 0 ? value : fallback;
-}
-function nonNegativeFinite(value, fallback) {
-    return Number.isFinite(value) && (value ?? -1) >= 0 ? value : fallback;
-}
-function isEnvelope(value) {
-    if (!isObject(value))
-        return false;
-    return (value.schemaVersion === DOCUMENT_RECOVERY_JOURNAL_SCHEMA_VERSION && Array.isArray(value.records));
-}
-function isValidStoredRecord(value, timestamp, maxAgeMs, maxFutureSkewMs) {
-    if (!isObject(value))
-        return false;
-    if (!isValidTargetKey(value.targetKey) ||
-        !isNonNegativeSafeInteger(value.generation) ||
-        !isNonNegativeSafeInteger(value.revision) ||
-        typeof value.content !== 'string' ||
-        (value.persistedContent !== null && typeof value.persistedContent !== 'string') ||
-        !isNonNegativeFiniteNumber(value.createdAt) ||
-        !isNonNegativeFiniteNumber(value.updatedAt) ||
-        value.createdAt > value.updatedAt) {
-        return false;
-    }
-    if (!Number.isFinite(timestamp) || timestamp < 0)
-        return false;
-    if (value.updatedAt > timestamp + maxFutureSkewMs)
-        return false;
-    return timestamp - value.updatedAt <= maxAgeMs;
-}
-function isValidWrite(value) {
-    return (isValidTargetKey(value.targetKey) &&
-        isNonNegativeSafeInteger(value.generation) &&
-        isNonNegativeSafeInteger(value.revision) &&
-        typeof value.content === 'string' &&
-        (value.persistedContent === null || typeof value.persistedContent === 'string'));
-}
-function isValidAcknowledgement(value) {
-    return (isValidTargetKey(value.targetKey) &&
-        isNonNegativeSafeInteger(value.generation) &&
-        isNonNegativeSafeInteger(value.persistedRevision));
-}
-function isValidTargetKey(value) {
-    return typeof value === 'string' && value.length > 0 && value.length <= MAX_TARGET_KEY_LENGTH;
-}
-function isOptionalGeneration(value) {
-    return value === undefined || isNonNegativeSafeInteger(value);
-}
-function isNonNegativeSafeInteger(value) {
-    return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
-}
-function isNonNegativeFiniteNumber(value) {
-    return typeof value === 'number' && Number.isFinite(value) && value >= 0;
-}
-function isObject(value) {
-    return typeof value === 'object' && value !== null;
-}
-function isStorage(value) {
-    if (!isObject(value))
-        return false;
-    return (typeof value.getItem === 'function' &&
-        typeof value.setItem === 'function' &&
-        typeof value.removeItem === 'function');
-}
-function compareGenerationRevision(left, right) {
-    if (left.generation !== right.generation)
-        return left.generation - right.generation;
-    return left.revision - right.revision;
-}
-function compareStoredRecords(left, right) {
-    return compareGenerationRevision(left, right) || left.updatedAt - right.updatedAt;
-}
-function compareNewestFirst(left, right) {
-    return right.updatedAt - left.updatedAt || right.revision - left.revision;
-}
-function cloneRecord(record) {
-    return { ...record };
-}
-function evictOldest(records, protectedTarget) {
-    let oldestIndex = -1;
-    for (let index = 0; index < records.length; index += 1) {
-        if (records[index].targetKey === protectedTarget)
-            continue;
-        if (oldestIndex < 0 || compareNewestFirst(records[index], records[oldestIndex]) > 0) {
-            oldestIndex = index;
-        }
-    }
-    if (oldestIndex < 0)
-        return false;
-    records.splice(oldestIndex, 1);
-    return true;
-}
-//# sourceMappingURL=recovery-journal.js.map

package/dist/document/recovery-journal.js.map

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

package/dist/document/types.d.ts

@@ -1,89 +0,0 @@
-/**
- * Framework-neutral document persistence contracts.
- *
- * A DocumentSession owns one logical document at a time. Storage-specific
- * adapters implement DocumentCommitTarget; the session owns revisions,
- * serialization, lifecycle transitions, and conflict state.
- */
-import type { DocumentRecoveryJournal } from './recovery-journal.js';
-export type DocumentSaveReason = 'autosave' | 'manual' | 'transition' | 'close' | 'backup' | 'conflict';
-export type DocumentExternalVersion = string | number | null;
-export interface DocumentCommitRequest {
-    /** Stable key for the target this commit was created for. */
-    targetKey: string;
-    /** Latest complete document snapshot to persist. */
-    content: string;
-    /** Monotonic session revision represented by content. */
-    revision: number;
-    /** Most recent revision acknowledged by this target. */
-    persistedRevision: number;
-    /** Content last acknowledged by the target, or null if it did not exist. */
-    persistedContent: string | null;
-    reason: DocumentSaveReason;
-}
-export interface DocumentCommitResult {
-    /** Optional backend version (mtime, TextDocument.version, etag, and so on). */
-    version?: DocumentExternalVersion;
-}
-export interface DocumentCommitTarget {
-    readonly key: string;
-    commit(request: DocumentCommitRequest): Promise<DocumentCommitResult | void>;
-}
-export type DocumentSessionStatus = 'idle' | 'saved' | 'dirty' | 'saving' | 'error' | 'conflict' | 'closed';
-export type DocumentSessionLifecycle = 'open' | 'transitioning' | 'closing' | 'closed';
-export interface DocumentExternalSnapshot {
-    /** Target key captured before the external read began. */
-    targetKey: string;
-    /** Monotonic observation number assigned by the target watcher. */
-    sequence?: number;
-    /** Null represents an externally deleted document. */
-    content: string | null;
-    version?: DocumentExternalVersion;
-}
-export interface DocumentSessionConflict {
-    targetKey: string;
-    localContent: string;
-    localRevision: number;
-    externalContent: string | null;
-    externalVersion: DocumentExternalVersion;
-}
-export interface DocumentSessionSnapshot {
-    targetKey: string | null;
-    content: string;
-    revision: number;
-    persistedRevision: number;
-    persistedContent: string | null;
-    savingRevision: number | null;
-    generation: number;
-    status: DocumentSessionStatus;
-    lifecycle: DocumentSessionLifecycle;
-    frozen: boolean;
-    error: Error | null;
-    conflict: DocumentSessionConflict | null;
-}
-export interface DocumentSessionOptions {
-    autoSaveDelayMs?: number;
-    /** Whether edits schedule automatic persistence. Manual and lifecycle flushes remain available. */
-    autoSaveEnabled?: boolean;
-    /**
-     * Bounded delays used after an automatic save fails. Each entry permits
-     * one retry; exhausting the list leaves the session in error state until
-     * the user edits again or explicitly flushes it. Conflicts never retry.
-     */
-    autoSaveRetryDelaysMs?: readonly number[];
-    /** Optional synchronous crash-recovery journal owned by this session. */
-    recoveryJournal?: DocumentRecoveryJournal | null;
-}
-/** Scope captured by an editor instance when it mounts. */
-export interface DocumentSessionEditScope {
-    targetKey: string;
-    generation: number;
-}
-/** Result produced while a session transition is frozen. */
-export interface DocumentSessionTransition {
-    target: DocumentCommitTarget | null;
-    content: string;
-}
-export type DocumentExternalChangeResult = 'applied' | 'conflict' | 'ignored';
-export type DocumentConflictStrategy = 'use-local' | 'use-external';
-//# sourceMappingURL=types.d.ts.map

package/dist/document/types.d.ts.map

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

package/dist/document/types.js

@@ -1,9 +0,0 @@
-/**
- * Framework-neutral document persistence contracts.
- *
- * A DocumentSession owns one logical document at a time. Storage-specific
- * adapters implement DocumentCommitTarget; the session owns revisions,
- * serialization, lifecycle transitions, and conflict state.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/document/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/document/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/filesystem/commit-lock.d.ts

@@ -1,3 +0,0 @@
-/** Serialize conditional commits across providers and, when available, tabs. */
-export declare function withFileCommitLock<T>(key: string, operation: () => Promise<T>): Promise<T>;
-//# sourceMappingURL=commit-lock.d.ts.map

package/dist/filesystem/commit-lock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"commit-lock.d.ts","sourceRoot":"","sources":["../../src/filesystem/commit-lock.ts"],"names":[],"mappings":"AAQA,gFAAgF;AAChF,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAmBhG"}

package/dist/filesystem/commit-lock.js

@@ -1,20 +0,0 @@
-const localTails = new Map();
-/** Serialize conditional commits across providers and, when available, tabs. */
-export async function withFileCommitLock(key, operation) {
-    const lockManager = typeof navigator === 'undefined' ? undefined : navigator.locks;
-    if (lockManager) {
-        return lockManager.request(`docblocks:${key}`, operation);
-    }
-    const previous = localTails.get(key) ?? Promise.resolve();
-    const run = previous.then(operation, operation);
-    const tail = run.then(() => undefined, () => undefined);
-    localTails.set(key, tail);
-    try {
-        return await run;
-    }
-    finally {
-        if (localTails.get(key) === tail)
-            localTails.delete(key);
-    }
-}
-//# sourceMappingURL=commit-lock.js.map

package/dist/filesystem/commit-lock.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"commit-lock.js","sourceRoot":"","sources":["../../src/filesystem/commit-lock.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;AAEpD,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAI,GAAW,EAAE,SAA2B;IAClF,MAAM,WAAW,GACf,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,SAA2B,CAAC,KAAK,CAAC;IACpF,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC,OAAO,CAAC,aAAa,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1D,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CACnB,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;IACF,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;YAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/dist/filesystem/dbk-workspace.d.ts

@@ -1,34 +0,0 @@
-import type { ContentContainer } from '@bendyline/squisq/storage';
-import type { MemoryFileSystemProvider, MemoryFileSystemSnapshot } from './memory-provider.js';
-export type DbkWorkspaceAssetLayout = 'auto' | 'preserve' | 'companion';
-export interface DbkWorkspaceSnapshotOptions {
-    /** Provider-relative path of the transient workspace's active markdown file. */
-    targetDocumentPath: string;
-    /**
-     * `preserve` treats the DBK as a serialized workspace tree. `companion`
-     * rebases non-document files beneath `<document>_files/`. `auto` preserves
-     * a DBK whose primary path already matches the target, otherwise rebasing
-     * imported media into the companion directory.
-     */
-    assetLayout?: DbkWorkspaceAssetLayout;
-}
-export interface DbkWorkspaceSnapshot extends MemoryFileSystemSnapshot {
-    readonly sourceDocumentPath: string;
-    readonly targetDocumentPath: string;
-    readonly documentContent: string;
-    readonly assetLayout: Exclude<DbkWorkspaceAssetLayout, 'auto'>;
-}
-/**
- * Fully materialize and validate a DBK container before touching its target
- * provider. A missing or unreadable entry fails the snapshot as a whole.
- */
-export declare function createDbkWorkspaceSnapshot(source: ContentContainer, options: DbkWorkspaceSnapshotOptions): Promise<DbkWorkspaceSnapshot>;
-/**
- * Replace a transient DBK workspace as one logical operation.
- *
- * Container reads and validation happen before provider mutation. The memory
- * provider then stages and swaps the full tree synchronously, which removes
- * stale files and guarantees the old tree survives any failed replacement.
- */
-export declare function replaceMemoryWorkspaceFromDbk(provider: MemoryFileSystemProvider, source: ContentContainer, options: DbkWorkspaceSnapshotOptions): Promise<DbkWorkspaceSnapshot>;
-//# sourceMappingURL=dbk-workspace.d.ts.map

package/dist/filesystem/dbk-workspace.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dbk-workspace.d.ts","sourceRoot":"","sources":["../../src/filesystem/dbk-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EAEzB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;AAExE,MAAM,WAAW,2BAA2B;IAC1C,gFAAgF;IAChF,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC;AAED,MAAM,WAAW,oBAAqB,SAAQ,wBAAwB;IACpE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;CAChE;AAkBD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,oBAAoB,CAAC,CAgE/B;AAED;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CACjD,QAAQ,EAAE,wBAAwB,EAClC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,oBAAoB,CAAC,CAK/B"}