Context Creation and Management

/**
 * Create a WebGL rendering context
 * @param width - Width of the drawing buffer (must be > 0)
 * @param height - Height of the drawing buffer (must be > 0)
 * @param options - Optional context attributes
 * @returns WebGLRenderingContext or null if creation fails
 */
function createContext(width, height, options);

const gl = require('gl');

// Basic context creation
const context = gl(800, 600);

// Context with specific attributes
const context = gl(800, 600, {
  alpha: false,           // No alpha channel
  depth: true,            // Enable depth buffer
  stencil: true,          // Enable stencil buffer
  preserveDrawingBuffer: true  // Keep buffer after present
});

// Check if context creation succeeded
if (!context) {
  console.error('Failed to create WebGL context');
  return;
}

interface ContextAttributes {
  /** Enable alpha channel in color buffer (default: true) */
  alpha?: boolean;
  /** Enable depth buffer (default: true) */
  depth?: boolean;
  /** Enable stencil buffer (default: false) */
  stencil?: boolean;
  /** Enable antialiasing (default: false, overridden to false) */
  antialias?: boolean;
  /** Enable premultiplied alpha (default: true) */
  premultipliedAlpha?: boolean;
  /** Preserve drawing buffer contents (default: false) */
  preserveDrawingBuffer?: boolean;
  /** Prefer low power GPU (default: false) */
  preferLowPowerToHighPerformance?: boolean;
  /** Fail if major performance caveat (default: false) */
  failIfMajorPerformanceCaveat?: boolean;
}

interface WebGLRenderingContext {
  /** Current width of the drawing buffer */
  readonly drawingBufferWidth: number;
  /** Current height of the drawing buffer */
  readonly drawingBufferHeight: number;
}

/**
 * Get the current context attributes
 * @returns Context attributes object
 */
getContextAttributes(): ContextAttributes;

/**
 * Check if the context is lost (always returns false in headless-gl)
 * @returns false
 */
isContextLost(): boolean;

/**
 * Force execution of queued WebGL commands
 */
flush(): void;

/**
 * Wait for completion of all queued WebGL commands
 */
finish(): void;

// Check context attributes
const attrs = context.getContextAttributes();
console.log('Alpha enabled:', attrs.alpha);
console.log('Depth buffer:', attrs.depth);

// Get buffer dimensions
console.log('Buffer size:', context.drawingBufferWidth, 'x', context.drawingBufferHeight);

// Ensure commands are executed
context.flush();  // Force execution
context.finish(); // Wait for completion

// Automatic environment detection - no configuration needed
const gl = require('gl');
const context = gl(800, 600);

// Same API works in both environments
context.clearColor(0, 0, 0, 1);
context.clear(context.COLOR_BUFFER_BIT);