@csszyx/dynamic 0.7.0 → 0.9.0

package/tests/manifest.test.ts

@@ -1,177 +0,0 @@
-/**
- * Tests for manifest module.
- * Verifies manifest loading, caching, and delta check logic.
- */
-
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-
-import {
-    type CSSManifest,
-    ensureManifest,
-    isManifestLoaded,
-    lookupManifest,
-    preloadManifest,
-    resetManifest,
-} from '../src/manifest.js';
-
-// Mock fetch globally
-const mockFetch = vi.fn();
-vi.stubGlobal('fetch', mockFetch);
-
-/**
- * Creates a complete CSSManifest fixture with sensible defaults for testing.
- *
- * @param partial - optional overrides to merge into the default manifest
- * @returns a fully-formed CSSManifest object suitable for use in tests
- */
-function makeMockManifest(partial: Partial<CSSManifest> = {}): CSSManifest {
-    return {
-        version: '0.4.0',
-        buildId: 'test-build-id',
-        classes: ['p-4', 'bg-blue-500', 'flex', 'text-white'],
-        ...partial,
-    };
-}
-
-/**
- * Configures the global fetch mock to resolve successfully with the given manifest.
- *
- * @param manifest - the CSSManifest object that the mocked fetch should return
- * @returns void
- */
-function setupFetchSuccess(manifest: CSSManifest): void {
-    mockFetch.mockResolvedValueOnce({
-        ok: true,
-        json: () => Promise.resolve(manifest),
-    });
-}
-
-describe('manifest loading', () => {
-    beforeEach(() => {
-        resetManifest();
-        mockFetch.mockReset();
-    });
-
-    afterEach(() => {
-        resetManifest();
-    });
-
-    it('isManifestLoaded returns false before loading', () => {
-        expect(isManifestLoaded()).toBe(false);
-    });
-
-    it('lookupManifest returns null before manifest loads', () => {
-        expect(lookupManifest('p-4')).toBeNull();
-    });
-
-    it('preloadManifest fetches and caches manifest', async () => {
-        setupFetchSuccess(makeMockManifest());
-        await preloadManifest('/csszyx-manifest.json');
-
-        expect(isManifestLoaded()).toBe(true);
-        expect(mockFetch).toHaveBeenCalledWith('/csszyx-manifest.json');
-    });
-
-    it('uses custom URL passed to preloadManifest', async () => {
-        setupFetchSuccess(makeMockManifest());
-        await preloadManifest('/custom/path/manifest.json');
-
-        expect(mockFetch).toHaveBeenCalledWith('/custom/path/manifest.json');
-    });
-
-    it('coalesces concurrent ensureManifest calls', async () => {
-        setupFetchSuccess(makeMockManifest());
-
-        // Trigger two concurrent loads
-        const p1 = ensureManifest();
-        const p2 = ensureManifest();
-        await Promise.all([p1, p2]);
-
-        // Only one fetch should have been made
-        expect(mockFetch).toHaveBeenCalledTimes(1);
-    });
-
-    it('gracefully handles fetch failure — treats all classes as new', async () => {
-        mockFetch.mockRejectedValueOnce(new Error('network error'));
-        await ensureManifest();
-
-        expect(isManifestLoaded()).toBe(true); // loaded (empty fallback)
-        expect(lookupManifest('p-4')).toBeNull(); // not in empty set
-    });
-
-    it('gracefully handles non-ok response', async () => {
-        mockFetch.mockResolvedValueOnce({ ok: false, status: 404 });
-        await ensureManifest();
-
-        expect(isManifestLoaded()).toBe(true);
-        expect(lookupManifest('p-4')).toBeNull();
-    });
-});
-
-describe('manifest delta check', () => {
-    beforeEach(async () => {
-        resetManifest();
-        mockFetch.mockReset();
-        setupFetchSuccess(makeMockManifest());
-        await preloadManifest();
-    });
-
-    afterEach(() => {
-        resetManifest();
-    });
-
-    it('returns original class name for class in manifest (no mangle map)', () => {
-        expect(lookupManifest('p-4')).toBe('p-4');
-        expect(lookupManifest('bg-blue-500')).toBe('bg-blue-500');
-        expect(lookupManifest('flex')).toBe('flex');
-    });
-
-    it('returns null for class not in manifest', () => {
-        expect(lookupManifest('p-7')).toBeNull(); // not in test manifest
-        expect(lookupManifest('bg-red-300')).toBeNull();
-    });
-
-    it('returns mangled name when mangle map is present', async () => {
-        resetManifest();
-        mockFetch.mockReset();
-        setupFetchSuccess(makeMockManifest({
-            classes: ['p-4', 'bg-blue-500'],
-            mangleMap: { 'p-4': 'z', 'bg-blue-500': 'y' },
-        }));
-        await preloadManifest();
-
-        expect(lookupManifest('p-4')).toBe('z');
-        expect(lookupManifest('bg-blue-500')).toBe('y');
-    });
-
-    it('returns original name for class in manifest but not in mangle map', async () => {
-        resetManifest();
-        mockFetch.mockReset();
-        setupFetchSuccess(makeMockManifest({
-            classes: ['p-4', 'flex'],
-            mangleMap: { 'p-4': 'z' }, // 'flex' not in mangle map
-        }));
-        await preloadManifest();
-
-        expect(lookupManifest('p-4')).toBe('z');
-        expect(lookupManifest('flex')).toBe('flex'); // original name
-    });
-});
-
-describe('resetManifest', () => {
-    it('clears loaded state and allows re-fetch', async () => {
-        setupFetchSuccess(makeMockManifest());
-        await preloadManifest();
-        expect(isManifestLoaded()).toBe(true);
-
-        resetManifest();
-        expect(isManifestLoaded()).toBe(false);
-        expect(lookupManifest('p-4')).toBeNull();
-
-        // Can reload after reset
-        setupFetchSuccess(makeMockManifest({ classes: ['new-class'] }));
-        await preloadManifest();
-        expect(lookupManifest('new-class')).toBe('new-class');
-        expect(lookupManifest('p-4')).toBeNull(); // old class gone
-    });
-});

package/tests/react.test.ts

@@ -1,221 +0,0 @@
-/**
- * Tests for the React integration layer (@csszyx/dynamic/react).
- *
- * React hooks cannot run outside a React render tree, so we mock the `react`
- * module to capture the effect callbacks passed to useEffect/useCallback/useContext.
- * This lets us invoke those callbacks directly and verify side-effects without
- * React Testing Library or a DOM environment.
- *
- * Coverage:
- * - sz export is the dynamic() alias
- * - useSz() returns { sz: fn } with a stable reference
- * - useSz() calls preloadManifest on mount
- * - useSz() schedules deferred cleanup (injectorCleanup + resetManifest) on unmount
- * - useSz() cancels pending cleanup when remounted (StrictMode resilience)
- * - CsszyxProvider calls setManifestUrl + preloadManifest on mount
- */
-
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-
-// ── Captured hook state ───────────────────────────────────────────────────────
-
-/**
- *
- */
-type EffectFn = () => (() => void) | void;
-
-let capturedEffects: EffectFn[] = [];
-let capturedCallback: ((...args: unknown[]) => unknown) | null = null;
-let contextValue = { manifestUrl: '/csszyx-manifest.json' };
-
-// ── Mock react ────────────────────────────────────────────────────────────────
-
-vi.mock('react', () => ({
-    createContext: vi.fn((defaultValue: unknown) => ({ _default: defaultValue, Provider: 'CsszyxContext.Provider' })),
-    createElement: vi.fn(
-        (type: unknown, props: Record<string, unknown> | null, ...children: unknown[]) =>
-            ({ type, props, children }),
-    ),
-    useCallback: vi.fn((fn: (...args: unknown[]) => unknown) => {
-        capturedCallback = fn;
-        return fn;
-    }),
-    useContext: vi.fn(() => contextValue),
-    useEffect: vi.fn((fn: EffectFn) => {
-        capturedEffects.push(fn);
-    }),
-}));
-
-// ── Mock internal modules ─────────────────────────────────────────────────────
-
-const mockDynamic = vi.fn((props: Record<string, unknown>) => `class-${JSON.stringify(props)}`);
-vi.mock('../src/index.js', () => ({ dynamic: mockDynamic }));
-
-const mockInjectorCleanup = vi.fn();
-vi.mock('../src/injector.js', () => ({ cleanup: mockInjectorCleanup }));
-
-const mockPreloadManifest = vi.fn();
-const mockResetManifest = vi.fn();
-const mockSetManifestUrl = vi.fn();
-vi.mock('../src/manifest.js', () => ({
-    preloadManifest: mockPreloadManifest,
-    resetManifest: mockResetManifest,
-    setManifestUrl: mockSetManifestUrl,
-}));
-
-// ── Import subject under test (after mocks) ───────────────────────────────────
-
-const { sz, useSz, CsszyxProvider } = await import('../src/react.js');
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-/**
- * Runs all captured effects and returns their cleanup functions.
- * @returns array of cleanup functions returned by each effect (undefined entries filtered)
- */
-function runCapturedEffects(): Array<() => void> {
-    return capturedEffects
-        .map(fn => fn())
-        .filter((r): r is () => void => typeof r === 'function');
-}
-
-// ── Tests ─────────────────────────────────────────────────────────────────────
-
-describe('sz export', () => {
-    it('is the dynamic() alias', () => {
-        expect(sz).toBe(mockDynamic);
-    });
-
-    it('passes props through to dynamic()', () => {
-        sz({ p: 4, bg: 'blue-500' } as never);
-        expect(mockDynamic).toHaveBeenCalledWith({ p: 4, bg: 'blue-500' });
-    });
-});
-
-describe('useSz()', () => {
-    beforeEach(() => {
-        capturedEffects = [];
-        capturedCallback = null;
-        contextValue = { manifestUrl: '/csszyx-manifest.json' };
-        vi.useFakeTimers();
-    });
-
-    afterEach(() => {
-        vi.useRealTimers();
-        vi.clearAllMocks();
-    });
-
-    it('returns an object with a sz function', () => {
-        const result = useSz();
-        expect(result).toHaveProperty('sz');
-        expect(typeof result.sz).toBe('function');
-    });
-
-    it('sz function delegates to dynamic()', () => {
-        const { sz: hookSz } = useSz();
-        hookSz({ m: 2 } as never);
-        expect(mockDynamic).toHaveBeenCalledWith({ m: 2 });
-    });
-
-    it('sz reference is stable (useCallback wraps it)', () => {
-        const { sz: hookSz } = useSz();
-        // capturedCallback is what useCallback returned — same as hookSz
-        expect(hookSz).toBe(capturedCallback);
-    });
-
-    it('reads manifestUrl from context', () => {
-        contextValue = { manifestUrl: '/custom/path.json' };
-        useSz();
-        runCapturedEffects();
-        expect(mockPreloadManifest).toHaveBeenCalledWith('/custom/path.json');
-    });
-
-    it('calls preloadManifest with default URL on mount', () => {
-        useSz();
-        runCapturedEffects();
-        expect(mockPreloadManifest).toHaveBeenCalledWith('/csszyx-manifest.json');
-    });
-
-    it('schedules deferred cleanup on unmount', () => {
-        useSz();
-        const cleanups = runCapturedEffects();
-        // Run all cleanup functions (simulate unmount)
-        cleanups.forEach(fn => fn());
-        // Cleanup should NOT have fired yet (timer pending)
-        expect(mockInjectorCleanup).not.toHaveBeenCalled();
-        expect(mockResetManifest).not.toHaveBeenCalled();
-        // After timer fires, cleanup runs
-        vi.runAllTimers();
-        expect(mockInjectorCleanup).toHaveBeenCalledOnce();
-        expect(mockResetManifest).toHaveBeenCalledOnce();
-    });
-
-    it('cancels pending cleanup when remounted (StrictMode resilience)', () => {
-        // First mount
-        useSz();
-        const firstCleanups = runCapturedEffects();
-
-        // StrictMode unmount — schedules cleanup timer
-        firstCleanups.forEach(fn => fn());
-        expect(mockInjectorCleanup).not.toHaveBeenCalled();
-
-        // StrictMode remount — second useSz() call, effect runs again, cancels timer
-        capturedEffects = [];
-        useSz();
-        runCapturedEffects();
-
-        // Timer fires — should have been cancelled by the second mount
-        vi.runAllTimers();
-        expect(mockInjectorCleanup).not.toHaveBeenCalled();
-        expect(mockResetManifest).not.toHaveBeenCalled();
-    });
-
-    it('runs cleanup after true unmount (no remount)', () => {
-        useSz();
-        const cleanups = runCapturedEffects();
-        cleanups.forEach(fn => fn());
-        // No remount — timer fires
-        vi.runAllTimers();
-        expect(mockInjectorCleanup).toHaveBeenCalledOnce();
-        expect(mockResetManifest).toHaveBeenCalledOnce();
-    });
-});
-
-describe('CsszyxProvider', () => {
-    beforeEach(() => {
-        capturedEffects = [];
-        vi.clearAllMocks();
-    });
-
-    it('calls setManifestUrl with the manifest prop', () => {
-        CsszyxProvider({ manifest: '/api/manifest.json', children: null });
-        runCapturedEffects();
-        expect(mockSetManifestUrl).toHaveBeenCalledWith('/api/manifest.json');
-    });
-
-    it('calls preloadManifest with the manifest prop', () => {
-        CsszyxProvider({ manifest: '/api/manifest.json', children: null });
-        runCapturedEffects();
-        expect(mockPreloadManifest).toHaveBeenCalledWith('/api/manifest.json');
-    });
-
-    it('re-runs effect when manifest URL changes', () => {
-        CsszyxProvider({ manifest: '/v1/manifest.json', children: null });
-        CsszyxProvider({ manifest: '/v2/manifest.json', children: null });
-        runCapturedEffects();
-        expect(mockSetManifestUrl).toHaveBeenCalledWith('/v1/manifest.json');
-        expect(mockSetManifestUrl).toHaveBeenCalledWith('/v2/manifest.json');
-        expect(mockPreloadManifest).toHaveBeenCalledWith('/v2/manifest.json');
-    });
-
-    it('renders children via createElement', async () => {
-        const { createElement } = await import('react');
-        const children = 'child-content';
-        CsszyxProvider({ manifest: '/manifest.json', children });
-        expect(createElement).toHaveBeenCalledWith(
-            expect.anything(),
-            expect.objectContaining({ value: { manifestUrl: '/manifest.json' } }),
-            children,
-        );
-    });
-});

package/tsconfig.json

@@ -1,10 +0,0 @@
-{
-    "extends": "../../tsconfig.json",
-    "compilerOptions": {
-        "rootDir": "./src",
-        "outDir": "./dist",
-        "types": ["vitest/globals"]
-    },
-    "include": ["src/**/*"],
-    "exclude": ["dist", "node_modules"]
-}

package/vitest.config.ts

@@ -1,8 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-    test: {
-        globals: true,
-        environment: 'node',
-    },
-});