Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
import { render, screen, waitFor } from '@testing-library/react';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
// The guard is what this covers the WIRING of, so it is stubbed to record the
// props it receives. Without this, `resetKey={url}` could be deleted at the
// call site and CoSCanvasGuard's own tests would stay green while switching
// characters after a failed model regressed in production.
const guardProps = vi.hoisted(() => []);
vi.mock('./CoSCanvasGuard', () => ({
default: (props) => {
guardProps.push(props);
return <div data-testid="canvas-guard" data-reset-key={props.resetKey}>{props.children}</div>;
},
}));
// jsdom has no WebGL context and none of the scene is under test here, so the
// Canvas is stubbed CHILDLESS — rendering the subtree would run three.js object
// code against r3f's HTMLElement stand-ins. Capture frameloop prop to verify
// reduced-motion behavior. The guard sits OUTSIDE the canvas.
const canvasProps = vi.hoisted(() => []);
vi.mock('@react-three/fiber', () => ({
Canvas: (props) => {
canvasProps.push(props);
return <div data-testid="mini-canvas" data-frameloop={props.frameloop} />;
},
useFrame: vi.fn(),
useThree: vi.fn(() => ({ invalidate: vi.fn() })),
}));
// Drei ships a CommonJS entry that pulls in three.cjs (THREE_CJS_DEPRECATED); the Canvas is stubbed, so the controls are never rendered.
vi.mock("@react-three/drei", () => ({ OrbitControls: () => null }));
let reduceMotionPreference = false;
vi.mock('../../hooks/usePrefersReducedMotion', () => ({
default: () => reduceMotionPreference,
}));
import MiniCharacterCoSAvatar from './MiniCharacterCoSAvatar';
describe('MiniCharacterCoSAvatar', () => {
beforeEach(() => {
guardProps.length = 0;
canvasProps.length = 0;
reduceMotionPreference = false;
// The component HEAD-probes the model before mounting the canvas.
vi.stubGlobal('fetch', vi.fn(() => Promise.resolve({ ok: true })));
});
afterEach(() => { vi.unstubAllGlobals(); });
// A single guard instance is reused across variants, so the guard needs to be
// told when the model changed — otherwise one character's dead GLB leaves the
// failure panel up for every character picked afterwards.
it('keys the canvas guard on the model url so switching characters clears a failure', async () => {
const { rerender } = render(<MiniCharacterCoSAvatar variant="mini-male-c" />);
await waitFor(() => expect(screen.getByTestId('canvas-guard')).toBeInTheDocument());
expect(screen.getByTestId('canvas-guard')).toHaveAttribute(
'data-reset-key',
'/api/avatar/model.glb?variant=mini-male-c',
);
rerender(<MiniCharacterCoSAvatar variant="mini-female-d" />);
await waitFor(() => expect(screen.getByTestId('canvas-guard')).toHaveAttribute(
'data-reset-key',
'/api/avatar/model.glb?variant=mini-female-d',
));
});
// A rigged record probes through the same variant namespace — the avatar
// route resolves `rigged-<modelId>` to the record's animated GLB, so the
// stage needs no special case for record-backed characters.
it('keys the canvas guard on the rigged variant url for an animated record', async () => {
render(<MiniCharacterCoSAvatar variant="rigged-image3d-1" coverage={null} />);
await waitFor(() => expect(screen.getByTestId('canvas-guard')).toHaveAttribute(
'data-reset-key',
'/api/avatar/model.glb?variant=rigged-image3d-1',
));
});
it('passes frameloop="demand" to Canvas when reduced motion is preferred', async () => {
reduceMotionPreference = true;
render(<MiniCharacterCoSAvatar variant="mini-male-c" />);
await waitFor(() => expect(screen.getByTestId('mini-canvas')).toHaveAttribute('data-frameloop', 'demand'));
});
it('passes frameloop="always" to Canvas when reduced motion is not preferred', async () => {
reduceMotionPreference = false;
render(<MiniCharacterCoSAvatar variant="mini-male-c" />);
await waitFor(() => expect(screen.getByTestId('mini-canvas')).toHaveAttribute('data-frameloop', 'always'));
});
});