Ztp3d Gaussian Splatting Streaming And Load State

---
name: ztp3d-gaussian-splatting-streaming-and-load-state
description: "Progressive Loading and Failure UX: specialized Perfect_AI quality workflow for Gaussian Splatting Engine."
---
# Progressive Loading and Failure UX

## Where this skill applies
Handle pending, ready, error, retry, cancel and obsolete requests; prevent stale async completions from overwriting a newer scene.

## Task-specific implementation plan
Track request tokens, guard the scene mount state, preserve existing renderer and recover to a static poster without blank screens. LoadingManager progress is not necessarily bytes.

### Inputs and dependencies
- Existing project source and its installed versions, target browser, 3D scene/camera, ownership rules.
- Parent integration guide: `../ztp3d-gaussian-splatting/SKILL.md`.
- Working example and adapter: `../../src/adapters/splat-vanilla.mjs`.
- Upstream technical reference: https://github.com/pmndrs/drei-vanilla.

### Step-by-step operational checklist
1. Inspect target source files and preserve all existing behavior; explicitly name the owner of each component, canvas and animation timeline.
2. Validate input data and preconditions. For missing support, stop gracefully with a useful error and a visible fallback.
3. Implement progressive loading and failure ux through smallest observable patch, preferring local modules, deterministic data and reusable functions.
4. Include edge cases: empty assets, large assets, stale asynchronous work, component unmount, 320px mobile, RTL layout and prefers-reduced-motion.
5. Verify each change independently before enabling it in the full pipeline; record precise reproduction steps.
6. Test final rendering on browser and target device and collect screenshot, console and resource lifecycle evidence.
7. Classify final result as documented / implemented / unit tested / browser tested / actual GPU tested.

### Targeted acceptance tests
Simulate slow asset, switch routes, fail fetch and verify no stale visual or unhandled rejection.

### Failure and rollback
- If a feature is unavailable, keep prior renderer or accessible HTML content intact and report why.
- If perf regresses, turn off the optional effect/plugin through an explicit feature flag.
- Do not change or delete upstream Perfect_AI skills; add new files or narrowly patch the destination application only on request.
- Always distinguish simulated/browser/device evidence.

### Example deliverables
- Implementation diff and dependency changes; deterministic fixture and tested commands.
- Baseline/target render screenshots and p95 frame-time notes where GPU work is involved.
- List of remaining limitations, security/privacy and licensing issues.