@bendyline/squisq 1.4.0 → 1.4.1

package/dist/versions/operations.js

@@ -1,190 +0,0 @@
-/**
- * Pure-ish version operations against a {@link ContentContainer}.
- *
- * These functions are the canonical implementation. {@link DocumentVersionManager}
- * is a thin wrapper that captures a container reference for ergonomics.
- */
-import { buildVersionPath, getDocBasename, parseVersionPath, VERSIONS_PREFIX } from './paths.js';
-const decoder = new TextDecoder();
-const encoder = new TextEncoder();
-async function resolveBasename(container, override) {
-    if (override)
-        return override;
-    const docPath = await container.getDocumentPath();
-    if (!docPath)
-        return null;
-    return getDocBasename(docPath);
-}
-async function resolveDocPath(container) {
-    // Default to `index.md` when the container has no document yet — matches
-    // `MemoryContentContainer.writeDocument`'s default.
-    const docPath = await container.getDocumentPath();
-    return docPath ?? 'index.md';
-}
-/**
- * List all snapshots in the container, newest-first.
- *
- * @param basename Optional filter: when set, only versions whose basename
- *   matches are returned.
- */
-export async function listVersions(container, basename) {
-    const entries = await container.listFiles(VERSIONS_PREFIX);
-    const versions = [];
-    for (const entry of entries) {
-        const parsed = parseVersionPath(entry.path);
-        if (!parsed)
-            continue;
-        if (basename !== undefined && parsed.basename !== basename)
-            continue;
-        versions.push({
-            path: entry.path,
-            basename: parsed.basename,
-            timestamp: parsed.timestamp,
-            size: entry.size,
-            collision: parsed.collision,
-        });
-    }
-    // Newest first. Tie-break on collision (higher = newer). Compare the
-    // numeric collision rather than the path string: lexicographically a path
-    // with no suffix sorts *after* one with `-N`, because `.` (0x2E) is
-    // greater than `-` (0x2D), which would invert the order.
-    versions.sort((a, b) => {
-        const dt = b.timestamp.getTime() - a.timestamp.getTime();
-        if (dt !== 0)
-            return dt;
-        return b.collision - a.collision;
-    });
-    return versions;
-}
-/**
- * Read the markdown content of a snapshot. Returns null if the snapshot
- * doesn't exist.
- */
-export async function readVersion(container, version) {
-    const path = typeof version === 'string' ? version : version.path;
-    const data = await container.readFile(path);
-    if (!data)
-        return null;
-    return decoder.decode(data);
-}
-/**
- * Save a new snapshot of the document if its content differs from the
- * latest existing snapshot.
- */
-export async function saveVersion(container, options = {}) {
-    const content = options.content ?? (await container.readDocument());
-    if (content === null || content === undefined) {
-        return { saved: false, version: null, reason: 'no-document' };
-    }
-    if (content.length === 0) {
-        return { saved: false, version: null, reason: 'empty' };
-    }
-    const basename = await resolveBasename(container, options.basename);
-    if (!basename) {
-        return { saved: false, version: null, reason: 'no-document' };
-    }
-    const versions = await listVersions(container, basename);
-    if (!options.force && versions.length > 0) {
-        const latest = versions[0];
-        const existing = await readVersion(container, latest);
-        if (existing === content) {
-            return { saved: false, version: null, reason: 'unchanged' };
-        }
-    }
-    const now = options.now ?? new Date();
-    let collision = 0;
-    let path = buildVersionPath(basename, now, collision);
-    while (await container.exists(path)) {
-        collision += 1;
-        path = buildVersionPath(basename, now, collision);
-    }
-    const data = encoder.encode(content);
-    await container.writeFile(path, data, 'text/markdown');
-    const version = {
-        path,
-        basename,
-        timestamp: now,
-        size: data.byteLength,
-        collision,
-    };
-    return { saved: true, version, reason: 'saved' };
-}
-/**
- * Revert the document to a prior snapshot. By default, the *current*
- * document is snapshotted first so the revert is itself recoverable.
- */
-export async function revertToVersion(container, version, options = {}) {
-    const content = await readVersion(container, version);
-    if (content === null) {
-        return { reverted: false, snapshotted: null };
-    }
-    let snapshotted = null;
-    if (options.snapshotCurrent !== false) {
-        const result = await saveVersion(container);
-        snapshotted = result.version;
-    }
-    const docPath = await resolveDocPath(container);
-    await container.writeDocument(content, docPath);
-    return { reverted: true, snapshotted };
-}
-/**
- * Delete snapshots that don't satisfy the policy. Returns the deleted
- * versions in their original (newest-first) order.
- */
-export async function pruneVersions(container, policy, basename) {
-    const versions = await listVersions(container, basename);
-    const toDelete = [];
-    if (policy.type === 'keep-last-n') {
-        const n = Math.max(0, Math.floor(policy.n));
-        toDelete.push(...versions.slice(n));
-    }
-    else if (policy.type === 'older-than') {
-        const cutoff = policy.date.getTime();
-        for (const v of versions) {
-            if (v.timestamp.getTime() < cutoff)
-                toDelete.push(v);
-        }
-    }
-    else {
-        for (const v of versions) {
-            if (!policy.keep(v, versions))
-                toDelete.push(v);
-        }
-    }
-    for (const v of toDelete) {
-        await container.removeFile(v.path);
-    }
-    return toDelete;
-}
-/**
- * Collapse adjacent snapshots that occurred close together — keeping the
- * newer one — to keep history readable across rapid edits.
- */
-export async function coalesceVersions(container, options = {}, basename) {
-    const windowMs = options.windowMs ?? 60000;
-    const versions = await listVersions(container, basename);
-    const toDelete = [];
-    // Walk newest -> oldest, anchored to the last *kept* snapshot. Any
-    // candidate within `windowMs` of the anchor is dropped; the first one
-    // outside the window becomes the new anchor. Comparing each pair against
-    // its previous neighbor instead would chain through deleted snapshots
-    // and over-prune any tightly-clustered run (e.g. 30s apart with a 60s
-    // window collapses to a single survivor).
-    if (versions.length > 0) {
-        let anchor = versions[0];
-        for (let i = 1; i < versions.length; i++) {
-            const candidate = versions[i];
-            if (anchor.timestamp.getTime() - candidate.timestamp.getTime() <= windowMs) {
-                toDelete.push(candidate);
-            }
-            else {
-                anchor = candidate;
-            }
-        }
-    }
-    for (const v of toDelete) {
-        await container.removeFile(v.path);
-    }
-    return toDelete;
-}
-//# sourceMappingURL=operations.js.map

package/dist/versions/operations.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/versions/operations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAUjG,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAClC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC,KAAK,UAAU,eAAe,CAC5B,SAA2B,EAC3B,QAA4B;IAE5B,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,eAAe,EAAE,CAAC;IAClD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,SAA2B;IACvD,yEAAyE;IACzE,oDAAoD;IACpD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,eAAe,EAAE,CAAC;IAClD,OAAO,OAAO,IAAI,UAAU,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAA2B,EAC3B,QAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ;YAAE,SAAS;QACrE,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;IACL,CAAC;IACD,qEAAqE;IACrE,0EAA0E;IAC1E,oEAAoE;IACpE,yDAAyD;IACzD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACzD,IAAI,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;IACnC,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAA2B,EAC3B,OAAyB;IAEzB,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAClE,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAA2B,EAC3B,UAA8B,EAAE;IAEhC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC;IACpE,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC1D,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAChE,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACtC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,IAAI,GAAG,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACtD,OAAO,MAAM,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,SAAS,IAAI,CAAC,CAAC;QACf,IAAI,GAAG,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;IAEvD,MAAM,OAAO,GAAY;QACvB,IAAI;QACJ,QAAQ;QACR,SAAS,EAAE,GAAG;QACd,IAAI,EAAE,IAAI,CAAC,UAAU;QACrB,SAAS;KACV,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAA2B,EAC3B,OAAyB,EACzB,UAAyB,EAAE;IAE3B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,IAAI,WAAW,GAAmB,IAAI,CAAC;IACvC,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;QAC5C,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAA2B,EAC3B,MAAmB,EACnB,QAAiB;IAEjB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,MAAM;gBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAA2B,EAC3B,UAA2B,EAAE,EAC7B,QAAiB;IAEjB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAM,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,mEAAmE;IACnE,sEAAsE;IACtE,yEAAyE;IACzE,sEAAsE;IACtE,sEAAsE;IACtE,0CAA0C;IAC1C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,IAAI,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;YAC/B,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC3E,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/versions/paths.d.ts

@@ -1,29 +0,0 @@
-/**
- * Path conventions for version snapshots.
- *
- * Snapshots live at `<VERSIONS_PREFIX><basename>.<timestamp>[<-suffix>].md`.
- * The optional numeric suffix (`-2`, `-3`, ...) is appended only when two
- * snapshots collide on the same UTC second.
- */
-/** Subfolder (inside the ContentContainer) that holds version snapshots. */
-export declare const VERSIONS_PREFIX = ".versions/";
-/**
- * Strip the directory and extension from a document path to produce the
- * basename used in version filenames. `subdir/index.md` -> `index`.
- */
-export declare function getDocBasename(documentPath: string): string;
-/**
- * Build a version snapshot path. Optionally append a collision suffix
- * (e.g. `2`, `3`) when two saves land on the same UTC second.
- */
-export declare function buildVersionPath(basename: string, date: Date, collision?: number): string;
-/**
- * Parse a version snapshot path. Returns null if it doesn't match the
- * convention (so unrelated files stored under `.versions/` are ignored).
- */
-export declare function parseVersionPath(path: string): {
-    basename: string;
-    timestamp: Date;
-    collision: number;
-} | null;
-//# sourceMappingURL=paths.d.ts.map

package/dist/versions/paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/versions/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,4EAA4E;AAC5E,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,SAAI,GAAG,MAAM,CAIpF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAyBjE"}

package/dist/versions/paths.js

@@ -1,66 +0,0 @@
-/**
- * Path conventions for version snapshots.
- *
- * Snapshots live at `<VERSIONS_PREFIX><basename>.<timestamp>[<-suffix>].md`.
- * The optional numeric suffix (`-2`, `-3`, ...) is appended only when two
- * snapshots collide on the same UTC second.
- */
-import { formatVersionTimestamp, parseVersionTimestamp } from './timestamp.js';
-/** Subfolder (inside the ContentContainer) that holds version snapshots. */
-export const VERSIONS_PREFIX = '.versions/';
-/**
- * Strip the directory and extension from a document path to produce the
- * basename used in version filenames. `subdir/index.md` -> `index`.
- */
-export function getDocBasename(documentPath) {
-    const slash = documentPath.lastIndexOf('/');
-    const file = slash >= 0 ? documentPath.slice(slash + 1) : documentPath;
-    const dot = file.lastIndexOf('.');
-    return dot > 0 ? file.slice(0, dot) : file;
-}
-/**
- * Build a version snapshot path. Optionally append a collision suffix
- * (e.g. `2`, `3`) when two saves land on the same UTC second.
- */
-export function buildVersionPath(basename, date, collision = 0) {
-    const stamp = formatVersionTimestamp(date);
-    const suffix = collision > 0 ? `-${collision + 1}` : '';
-    return `${VERSIONS_PREFIX}${basename}.${stamp}${suffix}.md`;
-}
-/**
- * Parse a version snapshot path. Returns null if it doesn't match the
- * convention (so unrelated files stored under `.versions/` are ignored).
- */
-export function parseVersionPath(path) {
-    if (!path.startsWith(VERSIONS_PREFIX))
-        return null;
-    const rest = path.slice(VERSIONS_PREFIX.length);
-    if (!rest.endsWith('.md'))
-        return null;
-    const stem = rest.slice(0, -'.md'.length);
-    // basename can contain dots; the timestamp is always the *last* dot-segment
-    // (optionally followed by a `-N` collision suffix).
-    const lastDot = stem.lastIndexOf('.');
-    if (lastDot <= 0)
-        return null;
-    const basename = stem.slice(0, lastDot);
-    const tail = stem.slice(lastDot + 1);
-    const dash = tail.indexOf('-');
-    let stamp;
-    let collision = 0;
-    if (dash >= 0) {
-        stamp = tail.slice(0, dash);
-        const n = Number(tail.slice(dash + 1));
-        if (!Number.isInteger(n) || n < 2)
-            return null;
-        collision = n - 1;
-    }
-    else {
-        stamp = tail;
-    }
-    const timestamp = parseVersionTimestamp(stamp);
-    if (!timestamp)
-        return null;
-    return { basename, timestamp, collision };
-}
-//# sourceMappingURL=paths.js.map

package/dist/versions/paths.js.map

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

package/dist/versions/timestamp.d.ts

@@ -1,22 +0,0 @@
-/**
- * Sortable, human-readable timestamps for version filenames.
- *
- * Format: ISO 8601 basic, UTC, second precision, `Z` suffix —
- * e.g. `20260430T152030Z`. Lexicographic order matches chronological order,
- * so `listFiles` returns versions in time order without parsing.
- */
-/**
- * Format a Date as a sortable, filename-safe UTC timestamp string.
- */
-export declare function formatVersionTimestamp(date: Date): string;
-/**
- * Parse a version timestamp string back to a Date. Returns null if the input
- * doesn't match the expected format.
- */
-export declare function parseVersionTimestamp(stamp: string): Date | null;
-/**
- * The pattern a valid version timestamp matches. Exported so other modules
- * can validate filenames without re-deriving the regex.
- */
-export declare const VERSION_TIMESTAMP_PATTERN: RegExp;
-//# sourceMappingURL=timestamp.d.ts.map

package/dist/versions/timestamp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"timestamp.d.ts","sourceRoot":"","sources":["../../src/versions/timestamp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAWzD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAOhE;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,QAAe,CAAC"}

package/dist/versions/timestamp.js

@@ -1,44 +0,0 @@
-/**
- * Sortable, human-readable timestamps for version filenames.
- *
- * Format: ISO 8601 basic, UTC, second precision, `Z` suffix —
- * e.g. `20260430T152030Z`. Lexicographic order matches chronological order,
- * so `listFiles` returns versions in time order without parsing.
- */
-const TIMESTAMP_RE = /^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})Z$/;
-function pad2(n) {
-    return n < 10 ? `0${n}` : String(n);
-}
-/**
- * Format a Date as a sortable, filename-safe UTC timestamp string.
- */
-export function formatVersionTimestamp(date) {
-    return (String(date.getUTCFullYear()).padStart(4, '0') +
-        pad2(date.getUTCMonth() + 1) +
-        pad2(date.getUTCDate()) +
-        'T' +
-        pad2(date.getUTCHours()) +
-        pad2(date.getUTCMinutes()) +
-        pad2(date.getUTCSeconds()) +
-        'Z');
-}
-/**
- * Parse a version timestamp string back to a Date. Returns null if the input
- * doesn't match the expected format.
- */
-export function parseVersionTimestamp(stamp) {
-    const m = TIMESTAMP_RE.exec(stamp);
-    if (!m)
-        return null;
-    const [, y, mo, d, h, mi, s] = m;
-    const ms = Date.UTC(Number(y), Number(mo) - 1, Number(d), Number(h), Number(mi), Number(s));
-    if (Number.isNaN(ms))
-        return null;
-    return new Date(ms);
-}
-/**
- * The pattern a valid version timestamp matches. Exported so other modules
- * can validate filenames without re-deriving the regex.
- */
-export const VERSION_TIMESTAMP_PATTERN = TIMESTAMP_RE;
-//# sourceMappingURL=timestamp.js.map

package/dist/versions/timestamp.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"timestamp.js","sourceRoot":"","sources":["../../src/versions/timestamp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,YAAY,GAAG,gDAAgD,CAAC;AAEtE,SAAS,IAAI,CAAC,CAAS;IACrB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAU;IAC/C,OAAO,CACL,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACvB,GAAG;QACH,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QAC1B,GAAG,CACJ,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAC"}

package/dist/versions/types.d.ts

@@ -1,92 +0,0 @@
-/**
- * Public types for the document version-history feature.
- *
- * Versions are snapshots of the primary markdown document stored alongside
- * the document inside the same {@link ContentContainer}. They live under
- * `.versions/<docBasename>.<sortableTimestamp>.md`. The container is the
- * unit of persistence — when the host serializes the container to a ZIP,
- * a real folder, or anywhere else, the version snapshots ride along.
- */
-/**
- * A single version snapshot record.
- */
-export interface Version {
-    /** Container-relative path, e.g. `.versions/index.20260430T152030Z.md`. */
-    path: string;
-    /** Document basename without extension, e.g. `index`. */
-    basename: string;
-    /** Parsed timestamp from the filename, in UTC. */
-    timestamp: Date;
-    /** Snapshot size in bytes. */
-    size: number;
-    /**
-     * Collision suffix index. `0` for a path with no `-N` suffix, `1` for `-2`,
-     * `2` for `-3`, and so on. Used as the tie-break for ordering snapshots
-     * that share the same UTC second.
-     */
-    collision: number;
-}
-/**
- * Result of a {@link saveVersion} call.
- */
-export interface SaveVersionResult {
-    /** True when a new snapshot file was actually written. */
-    saved: boolean;
-    /** The newly stamped version (only when `saved` is true). */
-    version: Version | null;
-    /**
-     * Why the save behaved the way it did:
-     * - `'saved'`        — a new snapshot was written.
-     * - `'unchanged'`    — current content matches the latest snapshot byte-for-byte.
-     * - `'no-document'`  — the container has no primary markdown document.
-     * - `'empty'`        — the resolved content was empty.
-     */
-    reason: 'saved' | 'unchanged' | 'no-document' | 'empty';
-}
-/**
- * Options for {@link saveVersion}.
- */
-export interface SaveVersionOptions {
-    /** Override the document content; otherwise the container's primary doc is read. */
-    content?: string;
-    /** Override the timestamp; defaults to `new Date()`. Useful for tests. */
-    now?: Date;
-    /** Skip the diff-vs-latest check and force a write. */
-    force?: boolean;
-    /** Override the document basename used to build the version filename. */
-    basename?: string;
-}
-/**
- * Pruning policy passed to {@link pruneVersions}.
- */
-export type PrunePolicy = {
-    type: 'keep-last-n';
-    n: number;
-} | {
-    type: 'older-than';
-    date: Date;
-} | {
-    type: 'predicate';
-    keep: (v: Version, all: Version[]) => boolean;
-};
-/**
- * Options for {@link revertToVersion}.
- */
-export interface RevertOptions {
-    /**
-     * Whether to snapshot the current document content before replacing it.
-     * Defaults to `true` so a revert is always recoverable.
-     */
-    snapshotCurrent?: boolean;
-}
-/**
- * Options for {@link coalesceVersions}.
- */
-export interface CoalesceOptions {
-    /**
-     * Two adjacent snapshots whose timestamps are within `windowMs` collapse
-     * to the newer one. Defaults to 60_000 (one minute).
-     */
-    windowMs?: number;
-}
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/versions/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,SAAS,EAAE,IAAI,CAAC;IAChB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,6DAA6D;IAC7D,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB;;;;;;OAMG;IACH,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,aAAa,GAAG,OAAO,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;CAAE,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/versions/types.js

@@ -1,11 +0,0 @@
-/**
- * Public types for the document version-history feature.
- *
- * Versions are snapshots of the primary markdown document stored alongside
- * the document inside the same {@link ContentContainer}. They live under
- * `.versions/<docBasename>.<sortableTimestamp>.md`. The container is the
- * unit of persistence — when the host serializes the container to a ZIP,
- * a real folder, or anywhere else, the version snapshots ride along.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/versions/types.js.map

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