SubMiner/src/main/runtime/linux-mpv-fullscreen-overlay-refresh.test.ts

import assert from 'node:assert/strict';
import test, { beforeEach, afterEach } from 'node:test';
import {
  clearLinuxMpvFullscreenOverlayRefreshTimeouts,
  updateLinuxMpvFullscreenOverlayRefreshBurst,
  scheduleLinuxVisibleOverlayFullscreenRefreshBurst,
} from './linux-mpv-fullscreen-overlay-refresh';

const compositorEnvKeys = [
  'HYPRLAND_INSTANCE_SIGNATURE',
  'SWAYSOCK',
  'XDG_CURRENT_DESKTOP',
  'XDG_SESSION_DESKTOP',
] as const;
const originalCompositorEnv = compositorEnvKeys.map((key) => [key, process.env[key]] as const);
beforeEach(() => {
  for (const key of compositorEnvKeys) delete process.env[key];
});
afterEach(() => {
  for (const [key, value] of originalCompositorEnv) {
    if (value === undefined) delete process.env[key];
    else process.env[key] = value;
  }
});

for (const { compositorKey, expectedRefreshCalls } of [
  {
    compositorKey: 'HYPRLAND_INSTANCE_SIGNATURE',
    expectedRefreshCalls: ['mode', 'visibility', 'mouse', 'restack'],
  },
  {
    compositorKey: 'SWAYSOCK',
    expectedRefreshCalls: ['mode', 'visibility', 'hide', 'showInactive', 'mouse', 'restack'],
  },
]) {
  test(`${compositorKey} fullscreen refresh uses compositor-specific restacking`, async () => {
    const originalPlatformDescriptor = Object.getOwnPropertyDescriptor(process, 'platform');
    Object.defineProperty(process, 'platform', { configurable: true, value: 'linux' });
    process.env[compositorKey] = 'fullscreen-refresh-test';
    const calls: string[] = [];
    try {
      scheduleLinuxVisibleOverlayFullscreenRefreshBurst(true, {
        overlayManager: {
          getMainWindow: () => ({
            hide: () => calls.push('hide'),
            showInactive: () => calls.push('showInactive'),
            isDestroyed: () => false,
            isVisible: () => true,
            setIgnoreMouseEvents: () => calls.push('mouse'),
          }),
          getVisibleOverlayVisible: () => true,
        },
        overlayVisibilityRuntime: {
          updateVisibleOverlayVisibility: () => calls.push('visibility'),
        },
        syncVisibleOverlayMpvFullscreenMode: () => calls.push('mode'),
        ensureOverlayWindowLevel: () => calls.push('restack'),
      });
      await new Promise((resolve) => setTimeout(resolve, 700));
      assert.deepEqual(calls, Array.from({ length: 5 }, () => expectedRefreshCalls).flat());
    } finally {
      clearLinuxMpvFullscreenOverlayRefreshTimeouts();
      if (originalPlatformDescriptor) {
        Object.defineProperty(process, 'platform', originalPlatformDescriptor);
      }
    }
  });
}

test('linux mpv fullscreen overlay refresh burst schedules overlay refresh work on linux', async () => {
  const originalPlatformDescriptor = Object.getOwnPropertyDescriptor(process, 'platform');
  Object.defineProperty(process, 'platform', {
    configurable: true,
    value: 'linux',
  });

  const calls: string[] = [];

  try {
    scheduleLinuxVisibleOverlayFullscreenRefreshBurst(true, {
      overlayManager: {
        getMainWindow: () =>
          ({
            hide: () => calls.push('hide'),
            isFullScreen: () => false,
            isDestroyed: () => false,
            isVisible: () => true,
            setFullScreen: (fullscreen: boolean) => calls.push(`fullscreen:${fullscreen}`),
            setIgnoreMouseEvents: (ignore: boolean, options?: { forward?: boolean }) =>
              calls.push(
                `mouse-ignore:${ignore}:${options?.forward === true ? 'forward' : 'plain'}`,
              ),
            showInactive: () => calls.push('showInactive'),
          }) as never,
        getVisibleOverlayVisible: () => true,
      },
      overlayVisibilityRuntime: {
        updateVisibleOverlayVisibility: () => calls.push('updateVisibleOverlayVisibility'),
      },
      syncVisibleOverlayMpvFullscreenMode: (fullscreen: boolean) =>
        calls.push(`sync-overlay-mode:${fullscreen}`),
      ensureOverlayWindowLevel: () => calls.push('ensureOverlayWindowLevel'),
    });

    const deadline = Date.now() + 200;
    while (!calls.includes('updateVisibleOverlayVisibility') && Date.now() < deadline) {
      await new Promise((resolve) => setTimeout(resolve, 5));
    }

    assert.ok(calls.includes('updateVisibleOverlayVisibility'));
    assert.ok(calls.includes('sync-overlay-mode:true'));
    assert.ok(!calls.includes('fullscreen:true'));
    assert.ok(calls.includes('hide'));
    assert.ok(calls.includes('showInactive'));
    assert.ok(calls.includes('mouse-ignore:true:forward'));
    assert.ok(calls.includes('ensureOverlayWindowLevel'));
  } finally {
    clearLinuxMpvFullscreenOverlayRefreshTimeouts();
    if (originalPlatformDescriptor) {
      Object.defineProperty(process, 'platform', originalPlatformDescriptor);
    }
  }
});

test('linux mpv fullscreen overlay refresh remembers mode even when overlay is hidden', async () => {
  const originalPlatformDescriptor = Object.getOwnPropertyDescriptor(process, 'platform');
  Object.defineProperty(process, 'platform', {
    configurable: true,
    value: 'linux',
  });

  const calls: string[] = [];

  try {
    scheduleLinuxVisibleOverlayFullscreenRefreshBurst(true, {
      overlayManager: {
        getMainWindow: () => null,
        getVisibleOverlayVisible: () => false,
      },
      overlayVisibilityRuntime: {
        updateVisibleOverlayVisibility: () => calls.push('updateVisibleOverlayVisibility'),
      },
      syncVisibleOverlayMpvFullscreenMode: (fullscreen: boolean) =>
        calls.push(`sync-overlay-mode:${fullscreen}`),
      ensureOverlayWindowLevel: () => calls.push('ensureOverlayWindowLevel'),
    });

    const deadline = Date.now() + 200;
    while (!calls.includes('sync-overlay-mode:true') && Date.now() < deadline) {
      await new Promise((resolve) => setTimeout(resolve, 5));
    }

    assert.ok(calls.includes('sync-overlay-mode:true'));
    assert.ok(!calls.includes('updateVisibleOverlayVisibility'));
    assert.ok(!calls.includes('ensureOverlayWindowLevel'));
  } finally {
    clearLinuxMpvFullscreenOverlayRefreshTimeouts();
    if (originalPlatformDescriptor) {
      Object.defineProperty(process, 'platform', originalPlatformDescriptor);
    }
  }
});

test('linux mpv fullscreen overlay refresh updates mode without hide/show when fullscreen exits', async () => {
  const originalPlatformDescriptor = Object.getOwnPropertyDescriptor(process, 'platform');
  Object.defineProperty(process, 'platform', {
    configurable: true,
    value: 'linux',
  });

  const calls: string[] = [];

  try {
    const deps = {
      overlayManager: {
        getMainWindow: () =>
          ({
            hide: () => calls.push('hide'),
            isFullScreen: () => true,
            isDestroyed: () => false,
            isVisible: () => true,
            setFullScreen: (fullscreen: boolean) => calls.push(`fullscreen:${fullscreen}`),
            setIgnoreMouseEvents: (ignore: boolean, options?: { forward?: boolean }) =>
              calls.push(
                `mouse-ignore:${ignore}:${options?.forward === true ? 'forward' : 'plain'}`,
              ),
            showInactive: () => calls.push('showInactive'),
          }) as never,
        getVisibleOverlayVisible: () => true,
      },
      overlayVisibilityRuntime: {
        updateVisibleOverlayVisibility: () => calls.push('updateVisibleOverlayVisibility'),
      },
      syncVisibleOverlayMpvFullscreenMode: (fullscreen: boolean) =>
        calls.push(`sync-overlay-mode:${fullscreen}`),
      ensureOverlayWindowLevel: () => calls.push('ensureOverlayWindowLevel'),
    };

    const cancel = updateLinuxMpvFullscreenOverlayRefreshBurst(true, deps, null);
    const nextCancel = updateLinuxMpvFullscreenOverlayRefreshBurst(false, deps, cancel);

    await new Promise((resolve) => setTimeout(resolve, 80));

    assert.equal(typeof nextCancel, 'function');
    assert.ok(calls.includes('updateVisibleOverlayVisibility'));
    assert.ok(calls.includes('sync-overlay-mode:false'));
    assert.ok(!calls.includes('fullscreen:false'));
    assert.equal(calls.includes('hide'), false);
    assert.equal(calls.includes('showInactive'), false);
    assert.equal(calls.includes('mouse-ignore:true:forward'), false);
    assert.equal(calls.includes('ensureOverlayWindowLevel'), false);
  } finally {
    clearLinuxMpvFullscreenOverlayRefreshTimeouts();
    if (originalPlatformDescriptor) {
      Object.defineProperty(process, 'platform', originalPlatformDescriptor);
    }
  }
});

test('linux mpv fullscreen overlay refresh restores click-through after restacking', async () => {
  const originalPlatformDescriptor = Object.getOwnPropertyDescriptor(process, 'platform');
  Object.defineProperty(process, 'platform', {
    configurable: true,
    value: 'linux',
  });

  const calls: string[] = [];

  try {
    scheduleLinuxVisibleOverlayFullscreenRefreshBurst(true, {
      overlayManager: {
        getMainWindow: () =>
          ({
            hide: () => calls.push('hide'),
            isFullScreen: () => false,
            isDestroyed: () => false,
            isVisible: () => true,
            setFullScreen: (fullscreen: boolean) => calls.push(`fullscreen:${fullscreen}`),
            setIgnoreMouseEvents: (ignore: boolean, options?: { forward?: boolean }) =>
              calls.push(
                `mouse-ignore:${ignore}:${options?.forward === true ? 'forward' : 'plain'}`,
              ),
            showInactive: () => calls.push('showInactive'),
          }) as never,
        getVisibleOverlayVisible: () => true,
      },
      overlayVisibilityRuntime: {
        updateVisibleOverlayVisibility: () => calls.push('updateVisibleOverlayVisibility'),
      },
      syncVisibleOverlayMpvFullscreenMode: (fullscreen: boolean) =>
        calls.push(`sync-overlay-mode:${fullscreen}`),
      ensureOverlayWindowLevel: () => calls.push('ensureOverlayWindowLevel'),
    });

    const deadline = Date.now() + 200;
    while (!calls.includes('mouse-ignore:true:forward') && Date.now() < deadline) {
      await new Promise((resolve) => setTimeout(resolve, 5));
    }

    const showIndex = calls.indexOf('showInactive');
    const passthroughIndex = calls.indexOf('mouse-ignore:true:forward');
    const levelIndex = calls.indexOf('ensureOverlayWindowLevel');
    const syncIndex = calls.indexOf('sync-overlay-mode:true');

    assert.ok(syncIndex >= 0);
    assert.ok(showIndex >= 0);
    assert.ok(syncIndex < showIndex);
    assert.ok(passthroughIndex > showIndex);
    assert.ok(levelIndex > passthroughIndex);
  } finally {
    clearLinuxMpvFullscreenOverlayRefreshTimeouts();
    if (originalPlatformDescriptor) {
      Object.defineProperty(process, 'platform', originalPlatformDescriptor);
    }
  }
});

test('linux mpv fullscreen overlay refresh preserves active subtitle interaction after restacking', async () => {
  const originalPlatformDescriptor = Object.getOwnPropertyDescriptor(process, 'platform');
  Object.defineProperty(process, 'platform', {
    configurable: true,
    value: 'linux',
  });

  const calls: string[] = [];

  try {
    scheduleLinuxVisibleOverlayFullscreenRefreshBurst(true, {
      overlayManager: {
        getMainWindow: () =>
          ({
            hide: () => calls.push('hide'),
            isFullScreen: () => false,
            isDestroyed: () => false,
            isVisible: () => true,
            setFullScreen: (fullscreen: boolean) => calls.push(`fullscreen:${fullscreen}`),
            setIgnoreMouseEvents: (ignore: boolean, options?: { forward?: boolean }) =>
              calls.push(
                `mouse-ignore:${ignore}:${options?.forward === true ? 'forward' : 'plain'}`,
              ),
            showInactive: () => calls.push('showInactive'),
          }) as never,
        getVisibleOverlayVisible: () => true,
      },
      overlayVisibilityRuntime: {
        updateVisibleOverlayVisibility: () => calls.push('updateVisibleOverlayVisibility'),
      },
      syncVisibleOverlayMpvFullscreenMode: (fullscreen: boolean) =>
        calls.push(`sync-overlay-mode:${fullscreen}`),
      getOverlayInteractionActive: () => true,
      ensureOverlayWindowLevel: () => calls.push('ensureOverlayWindowLevel'),
    });

    const deadline = Date.now() + 200;
    while (!calls.includes('mouse-ignore:false:plain') && Date.now() < deadline) {
      await new Promise((resolve) => setTimeout(resolve, 5));
    }

    const showIndex = calls.indexOf('showInactive');
    const interactiveIndex = calls.indexOf('mouse-ignore:false:plain');

    assert.ok(showIndex >= 0);
    assert.ok(interactiveIndex > showIndex);
    assert.equal(calls.includes('mouse-ignore:true:forward'), false);
  } finally {
    clearLinuxMpvFullscreenOverlayRefreshTimeouts();
    if (originalPlatformDescriptor) {
      Object.defineProperty(process, 'platform', originalPlatformDescriptor);
    }
  }
});