Core Types

All types below are exported from @glyphcss/core unless marked with glyphcss (the vanilla package).

Geometry primitives

Type	Description	Used in
Vec2	[u, v] tuple — UV coordinates	TextureTriangle.uvs, polygon UVs
Vec3	[x, y, z] tuple — world-space point or vector	Vertices, directions, hotspot anchors
Polygon	N coplanar vertices + optional color/texture	Helper generators, mesh parsers
TextureTriangle	3 vertices + 3 UV pairs + optional color	Parser-internal type for UV-mapped meshes
WireframeEdge	from/to Vec3 pair + optional weight/color	buildSceneContext wireframe mode

type Vec2 = [number, number];
type Vec3 = [number, number, number];

interface Polygon {
  vertices: Vec3[];
  color?: string;
  texture?: string;
  uvs?: Vec2[];
}

interface TextureTriangle {
  vertices: [Vec3, Vec3, Vec3];
  uvs: [Vec2, Vec2, Vec2];
  color?: string;
}

interface WireframeEdge {
  from: Vec3;
  to: Vec3;
  weight?: EdgeWeight;  // 1 | 2 | 3
  color?: string;
}

Render mode and glyph mapping

Type	Description	Used in
RenderMode	"wireframe" | "solid" | "voxel"	SceneContextOptions.mode, all framework props
CharRamp	string[] — index 0 = darkest, last = brightest	Solid-mode Lambert → glyph mapping
EdgeWeight	1 | 2 | 3 — thin / normal / core	WireframeEdge.weight

type RenderMode = "wireframe" | "solid" | "voxel";
type CharRamp = string[];          // e.g. [" ", ".", ":", "-", "=", "+", "*", "#", "%", "@"]
type EdgeWeight = 1 | 2 | 3;

Lighting

Type	Description	Used in
GlyphDirectionalLight	Single distant light source	SceneContextOptions.directionalLight
GlyphAmbientLight	Uniform fill light	SceneContextOptions.ambientLight

interface GlyphDirectionalLight {
  direction: Vec3;
  intensity?: number;  // default 1
  color?: string;      // hex, default white
}

interface GlyphAmbientLight {
  intensity?: number;  // default 0.4
  color?: string;      // hex, default white
}

Shadows

Type	Description	Used in
GlyphShadowOptions	Shadow-map configuration. undefined on the scene = shadows off	SceneContextOptions.shadow, <GlyphScene shadow={…}>

interface GlyphShadowOptions {
  color?: string;      // shadow tint hex; default "#000000"
  opacity?: number;    // darkness 0..1 toward color; default 0.25
  lift?: number;       // depth bias — prevents self-shadow acne; default 0.05
  maxExtend?: number;  // half-extent of the light-space projection volume; default 2000
}

Shadow flags on meshes (GlyphMeshTransform, <GlyphMesh>, <glyph-mesh>):

Field / prop / attribute	Default	Description
castShadow / cast-shadow	false	This mesh casts shadows onto receiveShadow surfaces
receiveShadow / receive-shadow	false	This mesh receives shadows. Both flags on the same mesh = self-shadow

GlyphGround sets receiveShadow=true and castShadow=false by default.

Grid and scene

Type	Description	Used in
GridSize	{ cols, rows, cellAspect }	buildSceneContext, camera project()
SceneContext	Resolved scene state used by the rasterizer	buildSceneContext return value

interface GridSize {
  cols: number;
  rows: number;
  cellAspect: number;  // cellH / cellW — typically ~2.0
}

Hotspots

Type	Description	Used in
Hotspot	A 3D anchor that projects to a 2D hitbox	scene.addHotspot(), projectHotspots()
HotspotCell	Projected result for one frame	projectHotspots() return value

interface Hotspot {
  id: string;
  at: Vec3;
  size?: [number, number];  // cols × rows in cells; default [1, 1]
}

interface HotspotCell {
  id: string;
  col: number;
  row: number;
  depth: number;    // camera-space Z; use for z-index
  visible: boolean; // false when behind camera or off-grid
}

Parse results

Type	Description	Used in
ParseResult	Unified output of all polygon-emitting parsers	parseObj, parseGltf, loadMesh
ParseAnimationClip	Metadata for one animation in a glTF file	ParseResult.animation.clips

interface ParseResult {
  polygons: Polygon[];
  animation?: ParseAnimationController;
  objectUrls: string[];
  dispose: () => void;    // revoke blob URLs — always call on unmount
  warnings: string[];
  metadata?: {
    triangleCount?: number;
    meshes?: string[];
    materials?: string[];
    animations?: ParseAnimationClip[];
    sourceBytes?: number;
  };
}

interface ParseAnimationClip {
  index: number;
  name: string;
  duration: number;   // seconds
  channelCount: number;
}

Animation

Type	Description	Used in
GlyphAnimationMixer	Drives one or more animation actions against a mesh target	createGlyphAnimationMixer()
GlyphAnimationAction	Per-clip playback state	mixer.clipAction()

// Minimal usage — requires a glTF/GLB file with embedded animation clips.
// Replace "/character.glb" with the path to your own animated mesh.
import { createGlyphAnimationMixer, LoopRepeat, loadMesh } from "@glyphcss/core";

const { polygons, animation } = await loadMesh("/character.glb");
const mixer = createGlyphAnimationMixer(meshHandle, animation!);

const action = mixer.clipAction("walk");
action.setLoop(LoopRepeat, Infinity).play();

// In your animation loop (requestAnimationFrame):
mixer.update(deltaSeconds);