@fluxgpu/core

Graph orchestration, shadow state management, and validation for FluxGPU.

Overview

This package provides the core domain logic:

• ShadowState: CPU-side state tracking for GPU resources
• Graph Orchestration: Dependency resolution and command scheduling
• Validation: Resource lifecycle and state validation

Installation

pnpm add @fluxgpu/core

Usage

Shadow State

import { ShadowState } from '@fluxgpu/core';

const state = new ShadowState();

// Track buffer creation
state.createBuffer('buffer-1', { size: 1024, usage: 'storage' });

// Query state
const buffer = state.getBuffer('buffer-1');
console.log(buffer.size); // 1024

// Validate operations
state.validateWrite('buffer-1', 0, 512); // throws if invalid

Architecture Role

Part of the Domain Layer, this package:

• Depends only on @fluxgpu/contracts
• Contains pure business logic with no platform dependencies
• Can be tested without any GPU or browser APIs