@lakea/viz (Planned)

Not Yet Implemented

This package is planned but does not exist in the codebase yet. The structure below describes the intended design for future implementation.

Purpose

@lakea/viz provides low-level visualization utilities:

• D3 bindings — Reusable scales, axes, selections
• Three.js helpers — Scene setup, camera controls, star rendering
• Performance — LOD systems, culling, instancing

Planned Structure

packages/viz/src/
├── d3/
│   ├── scales.ts        # Astronomical scale helpers
│   ├── axes.ts          # RA/Dec axis formatting
│   └── bindData.ts      # Type-safe data binding
├── three/
│   ├── scene.ts         # Scene setup utilities
│   ├── camera.ts        # Orbital camera controls
│   ├── stars.ts         # Point cloud rendering
│   └── lod.ts           # Level of detail system
└── performance/
    ├── culling.ts       # Frustum culling
    └── instancing.ts    # GPU instancing helpers

Design Principles

1. Framework-agnostic — Works with React, vanilla JS, any framework
2. Performance-first — Designed for millions of data points
3. Type-safe — D3 selections and Three.js objects properly typed
4. Composable — Small functions that combine well