@blotch/dolan 0.0.0-stage → 22.2.0

package/dist/utils/animate.test.js

@@ -0,0 +1,365 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { fadeIn, fadeOut, scaleIn, scaleOut, slideIn, slideOut, popIn, popOut, pulse, shake, springTranslateX, revealIn, directionalSlideIn, overlayOpen, overlayClose, pressDown, pressRelease, DURATION, EASING, SCALE, } from './animate';
+/**
+ * The real Lynx element only needs an `animate()` method for the wrapper
+ * helpers below — everything else about the element is irrelevant to them.
+ * The mock returns a cancelable handle (mirroring the real API) so callers
+ * that store/inspect the return value have something realistic to work with.
+ */
+const createAnimateEl = () => ({
+    animate: vi.fn().mockReturnValue({ cancel: vi.fn() }),
+});
+const guardedCases = [
+    {
+        name: 'fadeIn',
+        call: fadeIn,
+        overrideOptions: { duration: 999, easing: 'linear', fill: 'both' },
+        expectedConfig: { duration: 999, easing: 'linear', fill: 'both' },
+        defaultConfig: {
+            duration: DURATION.normal,
+            easing: EASING.decelerate,
+            fill: 'forwards',
+        },
+    },
+    {
+        name: 'fadeOut',
+        call: fadeOut,
+        overrideOptions: { duration: 999, easing: 'linear', fill: 'both' },
+        expectedConfig: { duration: 999, easing: 'linear', fill: 'both' },
+        defaultConfig: {
+            duration: DURATION.fast,
+            easing: EASING.accelerate,
+            fill: 'forwards',
+        },
+    },
+    {
+        name: 'scaleIn',
+        call: scaleIn,
+        overrideOptions: {
+            duration: 999,
+            easing: 'linear',
+            fill: 'both',
+            fromScale: 0.5,
+            fromY: 40,
+        },
+        expectedConfig: { duration: 999, easing: 'linear', fill: 'both' },
+        defaultConfig: {
+            duration: DURATION.slow,
+            easing: EASING.springSubtle,
+            fill: 'forwards',
+        },
+    },
+    {
+        name: 'scaleOut',
+        call: scaleOut,
+        overrideOptions: {
+            duration: 999,
+            easing: 'linear',
+            fill: 'both',
+            toScale: 0.5,
+            toY: 40,
+        },
+        expectedConfig: { duration: 999, easing: 'linear', fill: 'both' },
+        defaultConfig: {
+            duration: DURATION.fast,
+            easing: EASING.accelerate,
+            fill: 'forwards',
+        },
+    },
+    {
+        name: 'popIn',
+        call: popIn,
+        overrideOptions: {
+            duration: 999,
+            easing: 'linear',
+            fill: 'both',
+            fromScale: 0.2,
+        },
+        expectedConfig: { duration: 999, easing: 'linear', fill: 'both' },
+        defaultConfig: {
+            duration: DURATION.fast,
+            easing: EASING.spring,
+            fill: 'forwards',
+        },
+    },
+    {
+        name: 'popOut',
+        call: popOut,
+        overrideOptions: {
+            duration: 999,
+            easing: 'linear',
+            fill: 'both',
+            toScale: 0.2,
+        },
+        expectedConfig: { duration: 999, easing: 'linear', fill: 'both' },
+        defaultConfig: {
+            duration: DURATION.instant,
+            easing: EASING.accelerate,
+            fill: 'forwards',
+        },
+    },
+    {
+        name: 'springTranslateX',
+        // fromX/toX are required positional args unrelated to `options`; pin
+        // them to fixed values so only the options behavior varies per case.
+        call: (el, options) => springTranslateX(el, 0, 100, options),
+        overrideOptions: { duration: 999, easing: 'linear', fill: 'both' },
+        expectedConfig: { duration: 999, easing: 'linear', fill: 'both' },
+        defaultConfig: { duration: 200, easing: EASING.spring, fill: 'forwards' },
+    },
+    {
+        name: 'revealIn',
+        call: revealIn,
+        overrideOptions: {
+            duration: 999,
+            easing: 'linear',
+            fill: 'both',
+            fromY: 40,
+        },
+        expectedConfig: { duration: 999, easing: 'linear', fill: 'both' },
+        defaultConfig: {
+            duration: DURATION.normal,
+            easing: EASING.decelerate,
+            fill: 'forwards',
+        },
+    },
+    {
+        name: 'directionalSlideIn',
+        call: (el, options) => directionalSlideIn(el, 1, options),
+        overrideOptions: {
+            duration: 999,
+            easing: 'linear',
+            fill: 'both',
+            distance: 50,
+        },
+        expectedConfig: { duration: 999, easing: 'linear', fill: 'both' },
+        defaultConfig: {
+            duration: DURATION.slow,
+            easing: EASING.springSubtle,
+            fill: 'forwards',
+        },
+    },
+];
+describe.each(guardedCases)('$name', ({ call, overrideOptions, expectedConfig, defaultConfig }) => {
+    it('returns undefined and does not throw when el is falsy', () => {
+        expect(call(undefined)).toBeUndefined();
+    });
+    it('calls el.animate() with default values when no options are given', () => {
+        const el = createAnimateEl();
+        call(el);
+        expect(el.animate).toHaveBeenCalledTimes(1);
+        // Second arg to el.animate() is always the { duration, easing, fill }
+        // config object — checking it confirms every `?? DEFAULT` fired.
+        expect(el.animate.mock.calls[0][1]).toEqual(defaultConfig);
+    });
+    it('calls el.animate() with the provided options overriding every default', () => {
+        const el = createAnimateEl();
+        call(el, overrideOptions);
+        expect(el.animate).toHaveBeenCalledTimes(1);
+        expect(el.animate.mock.calls[0][1]).toEqual(expectedConfig);
+    });
+});
+// ---------------------------------------------------------------------------
+// pulse — shares the "guarded" shape but its options type only has
+// `duration` (no easing/fill), and the config includes a fixed `iterations:
+// Infinity` for the indefinite loop, so it doesn't fit the generic table.
+// ---------------------------------------------------------------------------
+describe('pulse', () => {
+    it('returns undefined when el is falsy', () => {
+        expect(pulse(undefined)).toBeUndefined();
+    });
+    it('defaults to a 1500ms ease-in-out loop', () => {
+        const el = createAnimateEl();
+        pulse(el);
+        expect(el.animate.mock.calls[0][1]).toEqual({
+            duration: 1500,
+            easing: 'ease-in-out',
+            iterations: Infinity,
+        });
+    });
+    it('honors an explicit duration', () => {
+        const el = createAnimateEl();
+        pulse(el, { duration: 3000 });
+        expect(el.animate.mock.calls[0][1]).toEqual({
+            duration: 3000,
+            easing: 'ease-in-out',
+            iterations: Infinity,
+        });
+    });
+});
+// ---------------------------------------------------------------------------
+// shake — also "guarded", but `fill` is hardcoded to 'forwards' rather than
+// read from options, so there is no `?? ` branch for it (unlike every other
+// AnimateOptions consumer). Passing `fill: 'both'` below is deliberate: it
+// proves the value is ignored rather than accidentally leaking through.
+// ---------------------------------------------------------------------------
+describe('shake', () => {
+    it('returns undefined when el is falsy', () => {
+        expect(shake(undefined)).toBeUndefined();
+    });
+    it('defaults duration and easing', () => {
+        const el = createAnimateEl();
+        shake(el);
+        expect(el.animate.mock.calls[0][1]).toEqual({
+            duration: DURATION.slow,
+            easing: EASING.standard,
+            fill: 'forwards',
+        });
+    });
+    it('honors explicit duration/easing but always fills forwards', () => {
+        const el = createAnimateEl();
+        shake(el, { duration: 999, easing: 'linear', fill: 'both' });
+        expect(el.animate.mock.calls[0][1]).toEqual({
+            duration: 999,
+            easing: 'linear',
+            fill: 'forwards',
+        });
+    });
+});
+// ---------------------------------------------------------------------------
+// slideIn / slideOut — guarded like the table above, but the direction is
+// resolved via an object-literal lookup (`{ up: ..., down: ... }[direction]`)
+// rather than an if/else, so a single direction is enough for branch
+// coverage. All four are still exercised for behavioral thoroughness since
+// each call is cheap and documents the intended keyframes per direction.
+// ---------------------------------------------------------------------------
+describe('slideIn', () => {
+    it('returns undefined when el is falsy', () => {
+        expect(slideIn(undefined, 'up')).toBeUndefined();
+    });
+    it.each(['up', 'down', 'left', 'right'])('animates the %s direction with default options', (direction) => {
+        const el = createAnimateEl();
+        slideIn(el, direction);
+        expect(el.animate).toHaveBeenCalledTimes(1);
+        expect(el.animate.mock.calls[0][1]).toEqual({
+            duration: DURATION.slow,
+            easing: EASING.sheet,
+            fill: 'forwards',
+        });
+    });
+    it('honors explicit options', () => {
+        const el = createAnimateEl();
+        slideIn(el, 'left', { duration: 999, easing: 'linear', fill: 'both' });
+        expect(el.animate.mock.calls[0][1]).toEqual({
+            duration: 999,
+            easing: 'linear',
+            fill: 'both',
+        });
+    });
+});
+describe('slideOut', () => {
+    it('returns undefined when el is falsy', () => {
+        expect(slideOut(undefined, 'up')).toBeUndefined();
+    });
+    it.each(['up', 'down', 'left', 'right'])('animates the %s direction with default options', (direction) => {
+        const el = createAnimateEl();
+        slideOut(el, direction);
+        expect(el.animate).toHaveBeenCalledTimes(1);
+        expect(el.animate.mock.calls[0][1]).toEqual({
+            duration: DURATION.normal,
+            easing: EASING.accelerate,
+            fill: 'forwards',
+        });
+    });
+    it('honors explicit options', () => {
+        const el = createAnimateEl();
+        slideOut(el, 'right', { duration: 999, easing: 'linear', fill: 'both' });
+        expect(el.animate.mock.calls[0][1]).toEqual({
+            duration: 999,
+            easing: 'linear',
+            fill: 'both',
+        });
+    });
+});
+// ---------------------------------------------------------------------------
+// overlayOpen / overlayClose — real if/else-if/else branches per `type`
+// (unlike the object-literal lookups above), so all four values must be
+// exercised to hit every branch.
+// ---------------------------------------------------------------------------
+describe('overlayOpen', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it.each(['center', 'bottom', 'left', 'right'])('schedules the panel animation for type=%s after the 30ms stagger', (type) => {
+        const backdrop = createAnimateEl();
+        const panel = createAnimateEl();
+        const result = overlayOpen(backdrop, panel, type);
+        // Backdrop fades in synchronously, before the stagger.
+        expect(backdrop.animate).toHaveBeenCalledTimes(1);
+        expect(result.backdrop).toBeDefined();
+        // Panel animation is deferred behind setTimeout(..., 30) — it must not
+        // have run yet, which is what makes this the branch under test rather
+        // than a duplicate of the scaleIn/slideIn unit tests above.
+        expect(panel.animate).not.toHaveBeenCalled();
+        vi.advanceTimersByTime(30);
+        // Firing the timer exercises the matching if/else-if/else arm for
+        // `type` inside the callback (scaleIn for 'center', slideIn otherwise).
+        expect(panel.animate).toHaveBeenCalledTimes(1);
+    });
+});
+describe('overlayClose', () => {
+    const cases = [
+        ['center', 180],
+        ['bottom', DURATION.normal],
+        ['left', DURATION.normal],
+        ['right', DURATION.normal],
+    ];
+    it.each(cases)('animates type=%s and returns duration %i', (type, expectedDuration) => {
+        const backdrop = createAnimateEl();
+        const panel = createAnimateEl();
+        const duration = overlayClose(backdrop, panel, type);
+        // Panel exit animation and backdrop fade both run synchronously.
+        expect(panel.animate).toHaveBeenCalledTimes(1);
+        expect(backdrop.animate).toHaveBeenCalledTimes(1);
+        expect(duration).toBe(expectedDuration);
+    });
+});
+// ---------------------------------------------------------------------------
+// pressDown / pressRelease (transitionTransform)
+//
+// transitionTransform is private, so it's only reachable through these two
+// exports. It guards with `el?.setStyle`, which is a distinct branch from a
+// plain `!el` check: it also returns undefined for a truthy object missing
+// `setStyle`, not just for a nullish `el`.
+// ---------------------------------------------------------------------------
+describe('pressDown / pressRelease', () => {
+    it('pressDown returns undefined when el is undefined', () => {
+        expect(pressDown(undefined)).toBeUndefined();
+    });
+    it('pressRelease returns undefined when el is undefined', () => {
+        expect(pressRelease(undefined)).toBeUndefined();
+    });
+    it('pressDown returns undefined when el has no setStyle', () => {
+        // A truthy object with no setStyle exercises the `?.` short-circuit
+        // itself, as opposed to the `el` being nullish outright above.
+        expect(pressDown({})).toBeUndefined();
+    });
+    it('pressRelease returns undefined when el has no setStyle', () => {
+        expect(pressRelease({})).toBeUndefined();
+    });
+    it('pressDown applies the default press-down scale', () => {
+        const el = { setStyle: vi.fn() };
+        const handle = pressDown(el);
+        expect(el.setStyle).toHaveBeenNthCalledWith(1, 'transition', `transform ${DURATION.instant}ms ${EASING.standard}`);
+        expect(el.setStyle).toHaveBeenNthCalledWith(2, 'transform', `scale(${SCALE.pressDown})`);
+        // cancel() is a real (if intentionally empty) function body — invoke it
+        // so it registers for function coverage, not just declaration coverage.
+        expect(() => handle?.cancel()).not.toThrow();
+    });
+    it('pressDown accepts an explicit scale overriding the default', () => {
+        const el = { setStyle: vi.fn() };
+        pressDown(el, 0.5);
+        expect(el.setStyle).toHaveBeenNthCalledWith(2, 'transform', 'scale(0.5)');
+    });
+    it('pressRelease transitions back to full scale with spring easing', () => {
+        const el = { setStyle: vi.fn() };
+        const handle = pressRelease(el);
+        expect(el.setStyle).toHaveBeenNthCalledWith(1, 'transition', `transform ${DURATION.fast}ms ${EASING.spring}`);
+        expect(el.setStyle).toHaveBeenNthCalledWith(2, 'transform', 'scale(1)');
+        handle?.cancel();
+    });
+});
+//# sourceMappingURL=animate.test.js.map

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

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

package/dist/utils/banner.d.ts

@@ -0,0 +1 @@
+export declare const printBanner: () => void;

package/dist/utils/banner.js

@@ -0,0 +1,15 @@
+import cfonts from 'cfonts';
+import pc from 'picocolors';
+export const printBanner = () => {
+    const rendered = cfonts.render('dolan', {
+        font: 'block',
+        colors: ['cyan', 'blue'],
+        space: false,
+    });
+    if (rendered) {
+        console.log(rendered.string);
+    }
+    console.log(pc.dim('  UI components for AngularLynx'));
+    console.log();
+};
+//# sourceMappingURL=banner.js.map

package/dist/utils/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/utils/banner.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,CAAC,MAAM,WAAW,GAAG,GAAS,EAAE;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;QACtC,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IAEH,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC,CAAC"}

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

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

package/dist/utils/banner.test.js

@@ -0,0 +1,29 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import cfonts from 'cfonts';
+import { printBanner } from './banner';
+describe('printBanner', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('prints the rendered cfonts banner plus the tagline', () => {
+        const spy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        printBanner();
+        // cfonts.render('dolan', ...) always returns a RenderedFontObject with a
+        // `.string` for this font/input, so the "rendered" branch is the normal
+        // path — asserting call count pins both the banner line and the tagline.
+        expect(spy).toHaveBeenCalled();
+        const output = spy.mock.calls.map((c) => String(c[0])).join('\n');
+        expect(output).toContain('AngularLynx');
+    });
+    it('skips the banner line when cfonts.render returns a falsy value', () => {
+        // cfonts can return undefined for degenerate input — guard against that
+        // rather than crash. Spy directly on the render method to force that
+        // branch deterministically.
+        vi.spyOn(cfonts, 'render').mockReturnValue(undefined);
+        const spy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        printBanner();
+        // Only the tagline + blank line are logged — no banner string line.
+        expect(spy).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=banner.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner.test.js","sourceRoot":"","sources":["../../src/utils/banner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClE,WAAW,EAAE,CAAC;QAEd,yEAAyE;QACzE,wEAAwE;QACxE,yEAAyE;QACzE,MAAM,CAAC,GAAG,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,wEAAwE;QACxE,qEAAqE;QACrE,4BAA4B;QAC5B,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,eAAe,CACxC,SAAwD,CACzD,CAAC;QAEF,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClE,WAAW,EAAE,CAAC;QAEd,oEAAoE;QACpE,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/cn.d.ts

@@ -0,0 +1,2 @@
+import { type ClassValue } from 'clsx';
+export declare const cn: (...inputs: ClassValue[]) => string;

package/dist/utils/cn.js

@@ -0,0 +1,6 @@
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+export const cn = (...inputs) => {
+    return twMerge(clsx(inputs));
+};
+//# sourceMappingURL=cn.js.map

package/dist/utils/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","sourceRoot":"","sources":["../../src/utils/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAoB,EAAU,EAAE;IACpD,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC"}

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

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

package/dist/utils/cn.test.js

@@ -0,0 +1,21 @@
+import { describe, it, expect } from 'vitest';
+import { cn } from './cn';
+describe('cn', () => {
+    it('joins plain class name strings', () => {
+        expect(cn('a', 'b')).toBe('a b');
+    });
+    it('drops falsy values (conditional classes)', () => {
+        const isActive = false;
+        expect(cn('a', isActive && 'b', undefined, null, 'c')).toBe('a c');
+    });
+    it('merges conflicting Tailwind utilities, keeping the last one', () => {
+        // twMerge should resolve conflicting padding utilities to the last-wins value —
+        // this is the whole reason cn() wraps clsx() with tailwind-merge instead of
+        // just joining strings.
+        expect(cn('p-2', 'p-4')).toBe('p-4');
+    });
+    it('supports object and array syntax from clsx', () => {
+        expect(cn(['a', { b: true, c: false }])).toBe('a b');
+    });
+});
+//# sourceMappingURL=cn.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cn.test.js","sourceRoot":"","sources":["../../src/utils/cn.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAE1B,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE;IAClB,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,QAAQ,GAAG,KAAK,CAAC;QACvB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,IAAI,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,gFAAgF;QAChF,4EAA4E;QAC5E,wBAAwB;QACxB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/format.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Normalizes upstream file content to the consuming project's oxfmt config.
+ *
+ * WHY THIS EXISTS: dolan copies component source verbatim and rewrites its
+ * import paths (`../../utils/cn` → `@blotch/dolan/utils/cn`). That copy is not
+ * guaranteed to satisfy the target project's formatter — the import rewrite
+ * alone can push a line past `printWidth`, and any drift in the upstream source
+ * lands as-is. Without normalization, `dolan add`/`update` writes files that
+ * the project's own `oxfmt --check` (and CI) then reject.
+ *
+ * It MUST run during analysis, not as a post-write pass: the lockfile records
+ * `hash(newContent)` as the merge base, and every command (`update`, `diff`,
+ * `outdated`, `list`) recomputes that hash to detect drift. If we formatted
+ * after writing, the on-disk content would no longer match the recorded hash
+ * and every file would read as "user-modified" forever. Normalizing the
+ * content itself keeps the hash, the diff, and the written file in agreement.
+ *
+ * BEST-EFFORT BY DESIGN: we only reformat when the target project genuinely
+ * uses oxfmt — i.e. both an `.oxfmtrc` config and an `oxfmt` binary are
+ * discoverable by walking up from `filePath`. Projects without oxfmt (and the
+ * temp-dir fixtures in our own unit tests, which live outside any workspace)
+ * get their content back unchanged, so dolan stays usable everywhere and its
+ * tests stay deterministic. Any formatter failure also falls back to the
+ * original content — a formatting hiccup must never corrupt the file we install.
+ *
+ * @param content  Raw (already import-rewritten) file content.
+ * @param filePath Absolute destination path inside the consumer project. Used
+ *                 to infer the parser (extension) and to resolve the project's
+ *                 oxfmt config/ignore rules exactly as `oxfmt` itself would.
+ */
+export declare const formatContent: (content: string, filePath: string) => string;

package/dist/utils/format.js

@@ -0,0 +1,95 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+// Extensions oxfmt understands. Everything else (notably the `.css` theme
+// files) is returned untouched — running them through a JS/TS formatter would
+// at best no-op and at worst mangle them.
+const FORMATTABLE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.mts',
+    '.cts',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+]);
+// oxfmt config filenames we treat as "this project uses oxfmt". We only look
+// for the JSON variants because that's what the schema-validated config in
+// this monorepo (and generated projects) use; a project on a `.ts`/`.js`
+// oxfmt config is niche enough that skipping formatting there is acceptable.
+const OXFMT_CONFIG_NAMES = ['.oxfmtrc.json', '.oxfmtrc.jsonc'];
+const extensionOf = (filePath) => {
+    const dot = filePath.lastIndexOf('.');
+    return dot === -1 ? '' : filePath.slice(dot);
+};
+/**
+ * Walks up the directory tree from `startDir`, returning the first ancestor
+ * that contains `relativePath`, or null if the filesystem root is reached
+ * without a hit. Used to discover the consumer's oxfmt config and binary.
+ */
+const findUp = (startDir, relativePath) => {
+    let dir = startDir;
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const candidate = join(dir, relativePath);
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null; // reached the filesystem root
+        dir = parent;
+    }
+};
+/**
+ * Normalizes upstream file content to the consuming project's oxfmt config.
+ *
+ * WHY THIS EXISTS: dolan copies component source verbatim and rewrites its
+ * import paths (`../../utils/cn` → `@blotch/dolan/utils/cn`). That copy is not
+ * guaranteed to satisfy the target project's formatter — the import rewrite
+ * alone can push a line past `printWidth`, and any drift in the upstream source
+ * lands as-is. Without normalization, `dolan add`/`update` writes files that
+ * the project's own `oxfmt --check` (and CI) then reject.
+ *
+ * It MUST run during analysis, not as a post-write pass: the lockfile records
+ * `hash(newContent)` as the merge base, and every command (`update`, `diff`,
+ * `outdated`, `list`) recomputes that hash to detect drift. If we formatted
+ * after writing, the on-disk content would no longer match the recorded hash
+ * and every file would read as "user-modified" forever. Normalizing the
+ * content itself keeps the hash, the diff, and the written file in agreement.
+ *
+ * BEST-EFFORT BY DESIGN: we only reformat when the target project genuinely
+ * uses oxfmt — i.e. both an `.oxfmtrc` config and an `oxfmt` binary are
+ * discoverable by walking up from `filePath`. Projects without oxfmt (and the
+ * temp-dir fixtures in our own unit tests, which live outside any workspace)
+ * get their content back unchanged, so dolan stays usable everywhere and its
+ * tests stay deterministic. Any formatter failure also falls back to the
+ * original content — a formatting hiccup must never corrupt the file we install.
+ *
+ * @param content  Raw (already import-rewritten) file content.
+ * @param filePath Absolute destination path inside the consumer project. Used
+ *                 to infer the parser (extension) and to resolve the project's
+ *                 oxfmt config/ignore rules exactly as `oxfmt` itself would.
+ */
+export const formatContent = (content, filePath) => {
+    if (!FORMATTABLE_EXTENSIONS.has(extensionOf(filePath)))
+        return content;
+    const startDir = dirname(filePath);
+    // Gate on the project actually using oxfmt. Checking the config first is the
+    // cheap, decisive signal; without it we'd risk formatting to oxfmt defaults
+    // in a project that never opted in.
+    const hasConfig = OXFMT_CONFIG_NAMES.some((name) => findUp(startDir, name));
+    if (!hasConfig)
+        return content;
+    const oxfmtBin = findUp(startDir, join('node_modules', '.bin', 'oxfmt'));
+    if (!oxfmtBin)
+        return content;
+    const result = spawnSync(oxfmtBin, ['--stdin-filepath', filePath], {
+        input: content,
+        encoding: 'utf-8',
+    });
+    if (result.status !== 0 || !result.stdout)
+        return content;
+    return result.stdout;
+};
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,0EAA0E;AAC1E,8EAA8E;AAC9E,0CAA0C;AAC1C,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC,CAAC;AAEH,6EAA6E;AAC7E,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;AAC7E,MAAM,kBAAkB,GAAG,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;AAE/D,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAU,EAAE;IAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,GAAG,CAAC,QAAgB,EAAE,YAAoB,EAAiB,EAAE;IACvE,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,iDAAiD;IACjD,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC1C,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,CAAC,8BAA8B;QAC/D,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,QAAgB,EAAU,EAAE;IACzE,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IAEvE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEnC,6EAA6E;IAC7E,4EAA4E;IAC5E,oCAAoC;IACpC,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5E,IAAI,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC;IAE/B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC;IAE9B,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,kBAAkB,EAAE,QAAQ,CAAC,EAAE;QACjE,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC,CAAC"}

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

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