@bendyline/squisq 1.4.0 → 1.4.1

package/dist/versions/index.d.ts

@@ -1,29 +1,128 @@
+import { C as CoalesceOptions, V as Version, P as PrunePolicy, R as RevertOptions, S as SaveVersionOptions, a as SaveVersionResult } from '../types-D98li1gV.js';
+import { C as ContentContainer } from '../ContentContainer-DNx460y8.js';
+
 /**
- * Document version history for Squisq.
+ * Pure-ish version operations against a {@link ContentContainer}.
  *
- * Snapshots of the primary markdown document live inside the same
- * {@link ContentContainer} at `.versions/<basename>.<timestamp>.md`.
- * Hosts call {@link DocumentVersionManager.saveVersion} (or the
- * underlying {@link saveVersion}) when they want to stamp a new version;
- * the editor's auto-save effect calls it on idle. Either way, snapshots
- * are written only when the document differs from the latest one.
+ * These functions are the canonical implementation. {@link DocumentVersionManager}
+ * is a thin wrapper that captures a container reference for ergonomics.
+ */
+
+/**
+ * List all snapshots in the container, newest-first.
+ *
+ * @param basename Optional filter: when set, only versions whose basename
+ *   matches are returned.
+ */
+declare function listVersions(container: ContentContainer, basename?: string): Promise<Version[]>;
+/**
+ * Read the markdown content of a snapshot. Returns null if the snapshot
+ * doesn't exist.
+ */
+declare function readVersion(container: ContentContainer, version: Version | string): Promise<string | null>;
+/**
+ * Save a new snapshot of the document if its content differs from the
+ * latest existing snapshot.
+ */
+declare function saveVersion(container: ContentContainer, options?: SaveVersionOptions): Promise<SaveVersionResult>;
+/**
+ * Revert the document to a prior snapshot. By default, the *current*
+ * document is snapshotted first so the revert is itself recoverable.
+ */
+declare function revertToVersion(container: ContentContainer, version: Version | string, options?: RevertOptions): Promise<{
+    reverted: boolean;
+    snapshotted: Version | null;
+}>;
+/**
+ * Delete snapshots that don't satisfy the policy. Returns the deleted
+ * versions in their original (newest-first) order.
+ */
+declare function pruneVersions(container: ContentContainer, policy: PrunePolicy, basename?: string): Promise<Version[]>;
+/**
+ * Collapse adjacent snapshots that occurred close together — keeping the
+ * newer one — to keep history readable across rapid edits.
+ */
+declare function coalesceVersions(container: ContentContainer, options?: CoalesceOptions, basename?: string): Promise<Version[]>;
+
+/**
+ * Convenience wrapper around the version operations that captures a
+ * {@link ContentContainer} reference and an optional basename override.
  *
- * @example
- * ```ts
- * import { DocumentVersionManager } from '@bendyline/squisq/versions';
+ * Hosts that prefer a stable handle (e.g. to pass into a UI component)
+ * use this; everything it does is also reachable as a free function.
+ */
+
+interface DocumentVersionManagerOptions {
+    /**
+     * Override the document basename used in version filenames. Defaults to
+     * the basename of `container.getDocumentPath()` resolved at call time.
+     */
+    basename?: string;
+}
+declare class DocumentVersionManager {
+    private readonly container;
+    private readonly basename;
+    constructor(container: ContentContainer, options?: DocumentVersionManagerOptions);
+    saveVersion(options?: SaveVersionOptions): Promise<SaveVersionResult>;
+    listVersions(): Promise<Version[]>;
+    readVersion(version: Version | string): Promise<string | null>;
+    revertToVersion(version: Version | string, options?: RevertOptions): Promise<{
+        reverted: boolean;
+        snapshotted: Version | null;
+    }>;
+    pruneVersions(policy: PrunePolicy): Promise<Version[]>;
+    coalesceVersions(options?: CoalesceOptions): Promise<Version[]>;
+}
+
+/**
+ * Sortable, human-readable timestamps for version filenames.
  *
- * const versioning = new DocumentVersionManager(container);
- * const result = await versioning.saveVersion();
- * if (result.saved) console.log('Stamped', result.version);
+ * 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.
+ */
+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.
+ */
+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.
+ */
+declare const VERSION_TIMESTAMP_PATTERN: RegExp;
+
+/**
+ * Path conventions for version snapshots.
  *
- * const history = await versioning.listVersions();
- * await versioning.revertToVersion(history[0]);
- * await versioning.pruneVersions({ type: 'keep-last-n', n: 50 });
- * ```
- */
-export type { Version, SaveVersionOptions, SaveVersionResult, PrunePolicy, RevertOptions, CoalesceOptions, } from './types.js';
-export { saveVersion, listVersions, readVersion, revertToVersion, pruneVersions, coalesceVersions, } from './operations.js';
-export { DocumentVersionManager, type DocumentVersionManagerOptions, } from './DocumentVersionManager.js';
-export { formatVersionTimestamp, parseVersionTimestamp, VERSION_TIMESTAMP_PATTERN, } from './timestamp.js';
-export { VERSIONS_PREFIX, getDocBasename, buildVersionPath, parseVersionPath } from './paths.js';
-//# sourceMappingURL=index.d.ts.map
+ * 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. */
+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`.
+ */
+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.
+ */
+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).
+ */
+declare function parseVersionPath(path: string): {
+    basename: string;
+    timestamp: Date;
+    collision: number;
+} | null;
+
+export { CoalesceOptions, DocumentVersionManager, type DocumentVersionManagerOptions, PrunePolicy, RevertOptions, SaveVersionOptions, SaveVersionResult, VERSIONS_PREFIX, VERSION_TIMESTAMP_PATTERN, Version, buildVersionPath, coalesceVersions, formatVersionTimestamp, getDocBasename, listVersions, parseVersionPath, parseVersionTimestamp, pruneVersions, readVersion, revertToVersion, saveVersion };

package/dist/versions/index.js

@@ -1,28 +1,35 @@
-/**
- * Document version history for Squisq.
- *
- * Snapshots of the primary markdown document live inside the same
- * {@link ContentContainer} at `.versions/<basename>.<timestamp>.md`.
- * Hosts call {@link DocumentVersionManager.saveVersion} (or the
- * underlying {@link saveVersion}) when they want to stamp a new version;
- * the editor's auto-save effect calls it on idle. Either way, snapshots
- * are written only when the document differs from the latest one.
- *
- * @example
- * ```ts
- * import { DocumentVersionManager } from '@bendyline/squisq/versions';
- *
- * const versioning = new DocumentVersionManager(container);
- * const result = await versioning.saveVersion();
- * if (result.saved) console.log('Stamped', result.version);
- *
- * const history = await versioning.listVersions();
- * await versioning.revertToVersion(history[0]);
- * await versioning.pruneVersions({ type: 'keep-last-n', n: 50 });
- * ```
- */
-export { saveVersion, listVersions, readVersion, revertToVersion, pruneVersions, coalesceVersions, } from './operations.js';
-export { DocumentVersionManager, } from './DocumentVersionManager.js';
-export { formatVersionTimestamp, parseVersionTimestamp, VERSION_TIMESTAMP_PATTERN, } from './timestamp.js';
-export { VERSIONS_PREFIX, getDocBasename, buildVersionPath, parseVersionPath } from './paths.js';
+import {
+  DocumentVersionManager,
+  VERSIONS_PREFIX,
+  buildVersionPath,
+  coalesceVersions,
+  getDocBasename,
+  listVersions,
+  parseVersionPath,
+  pruneVersions,
+  readVersion,
+  revertToVersion,
+  saveVersion
+} from "../chunk-VLJJHDAC.js";
+import {
+  VERSION_TIMESTAMP_PATTERN,
+  formatVersionTimestamp,
+  parseVersionTimestamp
+} from "../chunk-JELIRVDP.js";
+export {
+  DocumentVersionManager,
+  VERSIONS_PREFIX,
+  VERSION_TIMESTAMP_PATTERN,
+  buildVersionPath,
+  coalesceVersions,
+  formatVersionTimestamp,
+  getDocBasename,
+  listVersions,
+  parseVersionPath,
+  parseVersionTimestamp,
+  pruneVersions,
+  readVersion,
+  revertToVersion,
+  saveVersion
+};
 //# sourceMappingURL=index.js.map

package/dist/versions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/versions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAWH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,eAAe,EACf,aAAa,EACb,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,sBAAsB,GAEvB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",

package/dist/__tests__/animationUtils.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=animationUtils.test.d.ts.map

package/dist/__tests__/animationUtils.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"animationUtils.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/animationUtils.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/animationUtils.test.js

@@ -1,60 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { getAnimationStyle, getDefaultAnimationDuration, getTransitionClass, getAnimationProgress, } from '../doc/utils/animationUtils';
-describe('getAnimationStyle', () => {
-    it('returns empty for undefined animation', () => {
-        const result = getAnimationStyle(undefined);
-        expect(result.className).toBe('');
-        expect(result.style).toEqual({});
-    });
-    it('returns empty for type "none"', () => {
-        const result = getAnimationStyle({ type: 'none' });
-        expect(result.className).toBe('');
-    });
-    it('returns correct class for fadeIn', () => {
-        const result = getAnimationStyle({ type: 'fadeIn' });
-        expect(result.className).toBe('anim-fadeIn');
-    });
-    it('returns correct class for slowZoom with pan', () => {
-        const result = getAnimationStyle({ type: 'slowZoom', panDirection: 'left' });
-        expect(result.className).toBe('anim-slowZoom-panLeft');
-    });
-    it('includes CSS custom properties for duration and delay', () => {
-        const result = getAnimationStyle({ type: 'fadeIn', duration: 2, delay: 0.5 });
-        expect(result.style['--anim-duration']).toBe('2s');
-        expect(result.style['--anim-delay']).toBe('0.5s');
-    });
-});
-describe('getDefaultAnimationDuration', () => {
-    it('returns 8 for slowZoom', () => {
-        expect(getDefaultAnimationDuration('slowZoom')).toBe(8);
-    });
-    it('returns 1 for fadeIn', () => {
-        expect(getDefaultAnimationDuration('fadeIn')).toBe(1);
-    });
-    it('returns 0.5 for zoomIn', () => {
-        expect(getDefaultAnimationDuration('zoomIn')).toBe(0.5);
-    });
-});
-describe('getTransitionClass', () => {
-    it('returns enter class', () => {
-        expect(getTransitionClass('fade', true)).toBe('transition-fade-enter');
-    });
-    it('returns exit class', () => {
-        expect(getTransitionClass('dissolve', false)).toBe('transition-dissolve-exit');
-    });
-});
-describe('getAnimationProgress', () => {
-    it('returns 0 before delay', () => {
-        const progress = getAnimationProgress({ type: 'fadeIn', delay: 1, duration: 2 }, 0.5, 5);
-        expect(progress).toBe(0);
-    });
-    it('returns 1 after completion', () => {
-        const progress = getAnimationProgress({ type: 'fadeIn', delay: 0, duration: 2 }, 3, 5);
-        expect(progress).toBe(1);
-    });
-    it('returns 0.5 at midpoint', () => {
-        const progress = getAnimationProgress({ type: 'fadeIn', delay: 0, duration: 2 }, 1, 5);
-        expect(progress).toBeCloseTo(0.5);
-    });
-});
-//# sourceMappingURL=animationUtils.test.js.map

package/dist/__tests__/animationUtils.test.js.map

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

package/dist/__tests__/colorUtils.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=colorUtils.test.d.ts.map

package/dist/__tests__/colorUtils.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"colorUtils.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/colorUtils.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/colorUtils.test.js

@@ -1,94 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { isHex, oklchLighten, oklchDarken, oklchSetChroma, contrastRatio, pickContrastingText, deriveScale, relativeLuminance, } from '../schemas/colorUtils.js';
-describe('isHex', () => {
-    it('accepts #rgb and #rrggbb', () => {
-        expect(isHex('#fff')).toBe(true);
-        expect(isHex('#123abc')).toBe(true);
-        expect(isHex('#FF0080')).toBe(true);
-    });
-    it('rejects malformed strings', () => {
-        expect(isHex('fff')).toBe(false);
-        expect(isHex('#1234')).toBe(false);
-        expect(isHex('#xyz')).toBe(false);
-        expect(isHex('rgb(0,0,0)')).toBe(false);
-    });
-});
-describe('oklchLighten / oklchDarken', () => {
-    it('lighten produces a lighter color (higher luminance)', () => {
-        const dark = '#101010';
-        const lighter = oklchLighten(dark, 0.2);
-        expect(relativeLuminance(lighter)).toBeGreaterThan(relativeLuminance(dark));
-    });
-    it('darken produces a darker color (lower luminance)', () => {
-        const light = '#e0e0e0';
-        const darker = oklchDarken(light, 0.2);
-        expect(relativeLuminance(darker)).toBeLessThan(relativeLuminance(light));
-    });
-    it('round-trips approximately stable for moderate adjustments', () => {
-        const seed = '#3182ce';
-        const round = oklchDarken(oklchLighten(seed, 0.1), 0.1);
-        // sRGB gamut clamping prevents perfect round-trip; expect within a small epsilon.
-        expect(round).toMatch(/^#[0-9a-f]{6}$/);
-        const lumDiff = Math.abs(relativeLuminance(seed) - relativeLuminance(round));
-        expect(lumDiff).toBeLessThan(0.05);
-    });
-    it('returns a hex string', () => {
-        expect(oklchLighten('#3182ce', 0.1)).toMatch(/^#[0-9a-f]{6}$/);
-        expect(oklchDarken('#3182ce', 0.1)).toMatch(/^#[0-9a-f]{6}$/);
-    });
-    it('falls back to input on parse failure', () => {
-        expect(oklchLighten('not-a-color', 0.1)).toBe('not-a-color');
-    });
-});
-describe('oklchSetChroma', () => {
-    it('reducing chroma toward 0 desaturates a color', () => {
-        const vivid = '#ff3366';
-        const muted = oklchSetChroma(vivid, 0.1);
-        // Muted version's R/G/B channels should be much closer to each other than vivid.
-        const parse = (h) => [
-            parseInt(h.slice(1, 3), 16),
-            parseInt(h.slice(3, 5), 16),
-            parseInt(h.slice(5, 7), 16),
-        ];
-        const [vr, vg, vb] = parse(vivid);
-        const [mr, mg, mb] = parse(muted);
-        const vSpread = Math.max(vr, vg, vb) - Math.min(vr, vg, vb);
-        const mSpread = Math.max(mr, mg, mb) - Math.min(mr, mg, mb);
-        expect(mSpread).toBeLessThan(vSpread);
-    });
-});
-describe('contrastRatio', () => {
-    it('white-on-black is the maximum (≈21)', () => {
-        expect(contrastRatio('#ffffff', '#000000')).toBeCloseTo(21, 0);
-    });
-    it('same-color is 1', () => {
-        expect(contrastRatio('#aabbcc', '#aabbcc')).toBeCloseTo(1, 5);
-    });
-    it('is symmetric', () => {
-        expect(contrastRatio('#222', '#ddd')).toBeCloseTo(contrastRatio('#ddd', '#222'), 5);
-    });
-});
-describe('pickContrastingText', () => {
-    it('returns dark text for light backgrounds', () => {
-        expect(pickContrastingText('#ffffff')).toBe('#1a202c');
-        expect(pickContrastingText('#f7fafc')).toBe('#1a202c');
-    });
-    it('returns light text for dark backgrounds', () => {
-        expect(pickContrastingText('#000000')).toBe('#f7fafc');
-        expect(pickContrastingText('#1a202c')).toBe('#f7fafc');
-    });
-    it('respects custom light/dark options', () => {
-        expect(pickContrastingText('#000000', '#fefefe', '#020202')).toBe('#fefefe');
-    });
-});
-describe('deriveScale', () => {
-    it('produces 5 stops with base in the middle', () => {
-        const scale = deriveScale('#3182ce', 0.15);
-        expect(scale.base).toBe('#3182ce');
-        expect(relativeLuminance(scale.lighter2)).toBeGreaterThan(relativeLuminance(scale.lighter1));
-        expect(relativeLuminance(scale.lighter1)).toBeGreaterThan(relativeLuminance(scale.base));
-        expect(relativeLuminance(scale.base)).toBeGreaterThan(relativeLuminance(scale.darker1));
-        expect(relativeLuminance(scale.darker1)).toBeGreaterThan(relativeLuminance(scale.darker2));
-    });
-});
-//# sourceMappingURL=colorUtils.test.js.map

package/dist/__tests__/colorUtils.test.js.map

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

package/dist/__tests__/contentContainer.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=contentContainer.test.d.ts.map

package/dist/__tests__/contentContainer.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"contentContainer.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/contentContainer.test.ts"],"names":[],"mappings":""}