@blotch/dolan 0.0.0-stage → 22.2.1

package/dist/utils/analyze.js

@@ -0,0 +1,109 @@
+import pc from 'picocolors';
+import { diffLines, structuredPatch, applyPatch, } from 'diff';
+export const STATUS_ICONS = {
+    'up-to-date': pc.green('✓'),
+    'auto-update': pc.blue('↑'),
+    'user-modified': pc.yellow('~'),
+    conflict: pc.red('⚠'),
+    'new-upstream': pc.blue('+'),
+};
+export const STATUS_LABELS = {
+    'up-to-date': pc.dim('up to date'),
+    'auto-update': pc.blue('upstream updated → auto-update'),
+    'user-modified': pc.yellow('you modified → keeping yours'),
+    conflict: pc.red('conflict — both modified'),
+    'new-upstream': pc.blue('new file from upstream'),
+};
+/**
+ * Three-way merge status detection. The lockfile stores the hash of each
+ * file at install time (the "base"). Comparing current (user's file),
+ * upstream (bundled source), and base (lockfile hash) lets us determine
+ * who changed what:
+ *   base == current, base != upstream → upstream changed → safe auto-update
+ *   base != current, base == upstream → user changed → keep theirs
+ *   base != current, base != upstream → both changed → conflict
+ * When no base exists (missing lockfile entry), we can't tell who diverged,
+ * so any difference is flagged as a conflict to be safe.
+ */
+export const analyzeFile = (currentContent, newContent, storedHash, hashContent) => {
+    if (currentContent === null) {
+        return 'new-upstream';
+    }
+    const currentHash = hashContent(currentContent);
+    const newHash = hashContent(newContent);
+    if (storedHash === null) {
+        if (currentHash === newHash)
+            return 'up-to-date';
+        return 'conflict';
+    }
+    if (storedHash === currentHash && storedHash === newHash)
+        return 'up-to-date';
+    if (currentHash === newHash)
+        return 'up-to-date';
+    if (storedHash === currentHash && storedHash !== newHash)
+        return 'auto-update';
+    if (storedHash !== currentHash && storedHash === newHash)
+        return 'user-modified';
+    return 'conflict';
+};
+export const formatDiff = (currentContent, newContent) => {
+    const changes = diffLines(currentContent, newContent);
+    const lines = [];
+    for (const change of changes) {
+        const text = change.value.replace(/\n$/, '');
+        const changeLines = text.split('\n');
+        for (const line of changeLines) {
+            if (change.added) {
+                lines.push(pc.green(`+ ${line}`));
+            }
+            else if (change.removed) {
+                lines.push(pc.red(`- ${line}`));
+            }
+            else {
+                lines.push(pc.dim(`  ${line}`));
+            }
+        }
+    }
+    return lines.join('\n');
+};
+export const summarizeComponent = (analysis) => {
+    const statuses = analysis.files.map((f) => f.status);
+    if (statuses.includes('conflict'))
+        return 'conflict';
+    if (statuses.includes('auto-update') || statuses.includes('new-upstream'))
+        return 'auto-update';
+    if (statuses.includes('user-modified'))
+        return 'user-modified';
+    return 'up-to-date';
+};
+export const getHunks = (currentContent, newContent, context = 3) => {
+    const patch = structuredPatch('file', 'file', currentContent, newContent, '', '', {
+        context,
+    });
+    return patch.hunks;
+};
+export const formatHunk = (hunk) => {
+    const lines = [];
+    for (const line of hunk.lines) {
+        const prefix = line[0];
+        if (prefix === '+') {
+            lines.push(pc.green(line));
+        }
+        else if (prefix === '-') {
+            lines.push(pc.red(line));
+        }
+        else {
+            lines.push(pc.dim(line));
+        }
+    }
+    return lines.join('\n');
+};
+export const applySelectedHunks = (currentContent, newContent, acceptedIndices) => {
+    const patch = structuredPatch('file', 'file', currentContent, newContent);
+    const partial = {
+        ...patch,
+        hunks: patch.hunks.filter((_, i) => acceptedIndices.includes(i)),
+    };
+    return applyPatch(currentContent, partial);
+};
+//# sourceMappingURL=analyze.js.map

package/dist/utils/analyze.js.map

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

package/dist/utils/analyze.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/analyze.test.js

@@ -0,0 +1,146 @@
+import { describe, expect, it } from 'vitest';
+import { createHash } from 'node:crypto';
+import { analyzeFile, formatDiff, summarizeComponent } from './analyze';
+const hash = (content) => createHash('sha256').update(content).digest('hex').slice(0, 16);
+describe('analyzeFile', () => {
+    it('returns new-upstream when current content is null', () => {
+        expect(analyzeFile(null, 'new content', null, hash)).toBe('new-upstream');
+    });
+    it('returns up-to-date when current matches new (no stored hash)', () => {
+        expect(analyzeFile('same', 'same', null, hash)).toBe('up-to-date');
+    });
+    it('returns conflict when content differs with no stored hash', () => {
+        expect(analyzeFile('local', 'upstream', null, hash)).toBe('conflict');
+    });
+    it('returns up-to-date when all three hashes match', () => {
+        const stored = hash('content');
+        expect(analyzeFile('content', 'content', stored, hash)).toBe('up-to-date');
+    });
+    it('returns up-to-date when user made same change as upstream', () => {
+        const stored = hash('original');
+        expect(analyzeFile('updated', 'updated', stored, hash)).toBe('up-to-date');
+    });
+    it('returns auto-update when only upstream changed', () => {
+        const stored = hash('original');
+        expect(analyzeFile('original', 'new-upstream', stored, hash)).toBe('auto-update');
+    });
+    it('returns user-modified when only user changed', () => {
+        const stored = hash('original');
+        expect(analyzeFile('user-edit', 'original', stored, hash)).toBe('user-modified');
+    });
+    it('returns conflict when both user and upstream changed differently', () => {
+        const stored = hash('original');
+        expect(analyzeFile('user-edit', 'upstream-edit', stored, hash)).toBe('conflict');
+    });
+});
+describe('summarizeComponent', () => {
+    it('returns up-to-date when all files are up-to-date', () => {
+        const result = summarizeComponent({
+            name: 'test',
+            files: [
+                {
+                    file: 'a.ts',
+                    status: 'up-to-date',
+                    currentContent: '',
+                    newContent: '',
+                },
+                {
+                    file: 'b.ts',
+                    status: 'up-to-date',
+                    currentContent: '',
+                    newContent: '',
+                },
+            ],
+        });
+        expect(result).toBe('up-to-date');
+    });
+    it('returns conflict when any file has conflict', () => {
+        const result = summarizeComponent({
+            name: 'test',
+            files: [
+                {
+                    file: 'a.ts',
+                    status: 'auto-update',
+                    currentContent: '',
+                    newContent: '',
+                },
+                {
+                    file: 'b.ts',
+                    status: 'conflict',
+                    currentContent: '',
+                    newContent: '',
+                },
+            ],
+        });
+        expect(result).toBe('conflict');
+    });
+    it('returns auto-update when any file needs update (no conflicts)', () => {
+        const result = summarizeComponent({
+            name: 'test',
+            files: [
+                {
+                    file: 'a.ts',
+                    status: 'up-to-date',
+                    currentContent: '',
+                    newContent: '',
+                },
+                {
+                    file: 'b.ts',
+                    status: 'auto-update',
+                    currentContent: '',
+                    newContent: '',
+                },
+            ],
+        });
+        expect(result).toBe('auto-update');
+    });
+    it('returns auto-update for new-upstream files', () => {
+        const result = summarizeComponent({
+            name: 'test',
+            files: [
+                {
+                    file: 'a.ts',
+                    status: 'new-upstream',
+                    currentContent: '',
+                    newContent: '',
+                },
+            ],
+        });
+        expect(result).toBe('auto-update');
+    });
+    it('returns user-modified when only user changes exist', () => {
+        const result = summarizeComponent({
+            name: 'test',
+            files: [
+                {
+                    file: 'a.ts',
+                    status: 'up-to-date',
+                    currentContent: '',
+                    newContent: '',
+                },
+                {
+                    file: 'b.ts',
+                    status: 'user-modified',
+                    currentContent: '',
+                    newContent: '',
+                },
+            ],
+        });
+        expect(result).toBe('user-modified');
+    });
+});
+describe('formatDiff', () => {
+    it('produces output with added and removed lines', () => {
+        const result = formatDiff('line one\nline two\n', 'line one\nline three\n');
+        expect(result).toContain('line one');
+        expect(result).toContain('line two');
+        expect(result).toContain('line three');
+    });
+    it('returns context-only output for identical content', () => {
+        const result = formatDiff('same\n', 'same\n');
+        expect(result).toContain('same');
+        expect(result).not.toContain('+');
+        expect(result).not.toContain('-');
+    });
+});
+//# sourceMappingURL=analyze.test.js.map

package/dist/utils/analyze.test.js.map

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

package/dist/utils/animate.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Shared animation utility for @blotch/ui components.
+ *
+ * Centralizes all motion constants (durations, easing curves, scale factors)
+ * and provides reusable animation helpers that wrap the Lynx element.animate() API.
+ * This ensures a consistent, cohesive motion language across the entire component library.
+ */
+/**
+ * Duration constants in milliseconds
+ */
+export declare const DURATION: {
+    /**
+     * Micro-interactions: checkbox tick, radio dot
+     */
+    readonly instant: 100;
+    /**
+     * Press/release, thumb slide
+     */
+    readonly fast: 150;
+    /**
+     * Overlays, content transitions
+     */
+    readonly normal: 250;
+    /**
+     * Sheet/drawer slide, accordion expand
+     */
+    readonly slow: 350;
+};
+/**
+ * Easing curves for different animation contexts
+ */
+export declare const EASING: {
+    /**
+     * Entering elements — fast start, gentle stop
+     */
+    readonly decelerate: "cubic-bezier(0.0, 0.0, 0.2, 1)";
+    /**
+     * Exiting elements — gentle start, fast stop
+     */
+    readonly accelerate: "cubic-bezier(0.4, 0.0, 1, 1)";
+    /**
+     * General purpose movement
+     */
+    readonly standard: "cubic-bezier(0.4, 0.0, 0.2, 1)";
+    /**
+     * Bouncy overshoot — playful, energetic entrance
+     */
+    readonly spring: "cubic-bezier(0.34, 1.56, 0.64, 1)";
+    /**
+     * Gentle overshoot — refined entrance
+     */
+    readonly springSubtle: "cubic-bezier(0.22, 1.2, 0.36, 1)";
+    /**
+     * iOS-style sheet/drawer slide
+     */
+    readonly sheet: "cubic-bezier(0.32, 0.72, 0, 1)";
+};
+/**
+ * Scale factors for transform animations
+ */
+export declare const SCALE: {
+    /**
+     * Button/toggle press
+     */
+    readonly pressDown: 0.97;
+    /**
+     * List item / card press (lighter)
+     */
+    readonly pressDownLight: 0.985;
+    /**
+     * Small elements popping in (check, radio dot)
+     */
+    readonly popFrom: 0.6;
+    /**
+     * Dialog entrance starting scale
+     */
+    readonly dialogFrom: 0.9;
+    /**
+     * Dialog exit ending scale
+     */
+    readonly dialogTo: 0.95;
+};
+/**
+ * Options shared by most animation helpers
+ */
+export type AnimateOptions = {
+    duration?: number;
+    easing?: string;
+    fill?: 'none' | 'forwards' | 'backwards' | 'both';
+};
+/**
+ * A cancelable animation handle returned by Lynx element.animate()
+ */
+export type AnimationHandle = {
+    cancel(): void;
+};
+/**
+ * Fades an element in (opacity 0 → 1).
+ * Used for backdrops, content reveals, and soft entrances.
+ */
+export declare const fadeIn: (el: any, options?: AnimateOptions) => AnimationHandle | undefined;
+/**
+ * Fades an element out (opacity 1 → 0).
+ * Used for backdrops, content dismissals, and soft exits.
+ */
+export declare const fadeOut: (el: any, options?: AnimateOptions) => AnimationHandle | undefined;
+/**
+ * Scales and fades an element in — used for overlay panels (dialog, alert-dialog).
+ * Animates from a smaller scale + offset to full size.
+ */
+export declare const scaleIn: (el: any, options?: AnimateOptions & {
+    fromScale?: number;
+    fromY?: number;
+}) => AnimationHandle | undefined;
+/**
+ * Scales and fades an element out — used for overlay panel exit.
+ */
+export declare const scaleOut: (el: any, options?: AnimateOptions & {
+    toScale?: number;
+    toY?: number;
+}) => AnimationHandle | undefined;
+/**
+ * Slides an element in from a direction.
+ * Used for sheets (bottom), nav-drawers (left/right), toasts (bottom).
+ */
+export declare const slideIn: (el: any, direction: "up" | "down" | "left" | "right", options?: AnimateOptions) => AnimationHandle | undefined;
+/**
+ * Slides an element out to a direction.
+ */
+export declare const slideOut: (el: any, direction: "up" | "down" | "left" | "right", options?: AnimateOptions) => AnimationHandle | undefined;
+/**
+ * Pops a small element in with spring physics.
+ * Used for checkbox marks, radio dots, badges.
+ */
+export declare const popIn: (el: any, options?: AnimateOptions & {
+    fromScale?: number;
+}) => AnimationHandle | undefined;
+/**
+ * Pops a small element out (reverse of popIn).
+ */
+export declare const popOut: (el: any, options?: AnimateOptions & {
+    toScale?: number;
+}) => AnimationHandle | undefined;
+/**
+ * Animates an element being pressed down (scale shrink).
+ *
+ * Wire this to BOTH the touch and mouse press-start events —
+ * `(bindtouchstart)` and `(bindmousedown)`. Native (iOS/Android) only ever
+ * fires touch events; Lynx web runs in the browser, where a mouse press fires
+ * `mousedown` and NEVER `touchstart`. Mouse events are inert on touch devices,
+ * so binding both yields identical press-and-hold feedback across platforms.
+ * See `transitionTransform` for why this uses a CSS transition, not
+ * `el.animate()`.
+ */
+export declare const pressDown: (el: any, scale?: number) => AnimationHandle | undefined;
+/**
+ * Animates an element releasing from a press (scale back with spring).
+ *
+ * Wire this to the touch AND mouse release events — `(bindtouchend)` +
+ * `(bindtouchcancel)` and `(bindmouseup)` + `(bindmouseleave)`. See `pressDown`
+ * for why the mouse bindings are required on Lynx web. `mouseleave` is the
+ * `touchcancel` analogue: it restores the scale if the cursor leaves the
+ * element while still pressed.
+ */
+export declare const pressRelease: (el: any) => AnimationHandle | undefined;
+/**
+ * Orchestrates opening an overlay (backdrop + panel entrance).
+ * Provides staggered timing — backdrop fades first, then panel enters.
+ */
+export declare const overlayOpen: (backdrop: any, panel: any, type: "center" | "bottom" | "left" | "right") => {
+    backdrop?: AnimationHandle;
+    panel?: AnimationHandle;
+};
+/**
+ * Orchestrates closing an overlay (panel exits, then backdrop fades).
+ * Returns total animation duration for cleanup scheduling.
+ */
+export declare const overlayClose: (backdrop: any, panel: any, type: "center" | "bottom" | "left" | "right") => number;
+/**
+ * Creates a continuous pulse animation (for skeleton loading states).
+ * Oscillates opacity between 1 and 0.5 indefinitely.
+ */
+export declare const pulse: (el: any, options?: {
+    duration?: number;
+}) => AnimationHandle | undefined;
+/**
+ * Creates a horizontal shake animation (for error states on inputs).
+ * Shakes ±4px then ±2px before settling.
+ */
+export declare const shake: (el: any, options?: AnimateOptions) => AnimationHandle | undefined;
+/**
+ * Animates a spring-based translation between two X positions.
+ * Used for switch thumbs with a squish effect at midpoint.
+ */
+export declare const springTranslateX: (el: any, fromX: number, toX: number, options?: AnimateOptions) => AnimationHandle | undefined;
+/**
+ * Content reveal animation — fade in with upward slide.
+ * Used for accordion content, tab content, alerts, etc.
+ */
+export declare const revealIn: (el: any, options?: AnimateOptions & {
+    fromY?: number;
+}) => AnimationHandle | undefined;
+/**
+ * Direction-aware slide + fade for tab content transitions.
+ * Slides from left or right based on navigation direction, creating
+ * a spatial relationship between tab panels.
+ */
+export declare const directionalSlideIn: (el: any, direction: 1 | -1, options?: AnimateOptions & {
+    distance?: number;
+}) => AnimationHandle | undefined;