@pixygon/avatar 1.0.0

package/src/types/index.ts

@@ -0,0 +1,96 @@
+/**
+ * Avatar type definitions — mirrors the Rust AvatarAppearance from infinite-game.
+ *
+ * Keep in sync with: crates/infinite-game/src/avatar/mod.rs
+ */
+
+/** RGB colour triplet (0.0 – 1.0 per channel). */
+export type Colour3 = [number, number, number]
+
+/** Complete avatar appearance. */
+export interface AvatarAppearance {
+  body: AvatarBody
+  head: AvatarHead
+  skin_color: Colour3
+}
+
+/** Body shape parameters. */
+export interface AvatarBody {
+  /** 0.0 = short, 1.0 = tall */
+  height: number
+  /** 0.0 = thin, 1.0 = heavy */
+  build: number
+}
+
+/** Head & facial feature parameters. */
+export interface AvatarHead {
+  /** Head width scale (0.5 – 1.5, default 1.0) */
+  width: number
+  /** Head height scale (0.5 – 1.5, default 1.0) */
+  height: number
+
+  // Eyes
+  eye_style: number
+  eye_color: Colour3
+  eye_y: number
+  eye_spacing: number
+  eye_size: number
+  eye_rotation: number
+
+  // Eyebrows
+  brow_style: number
+  brow_color: Colour3
+  brow_y: number
+  brow_spacing: number
+  brow_size: number
+  brow_rotation: number
+
+  // Nose
+  nose_style: number
+  nose_y: number
+  nose_size: number
+
+  // Mouth
+  mouth_style: number
+  mouth_y: number
+  mouth_size: number
+  mouth_color: Colour3
+
+  // Hair
+  hair_style: number
+  hair_color: Colour3
+
+  // Facial hair (0 = none)
+  facial_hair_style: number
+  facial_hair_color: Colour3
+
+  // Glasses (0 = none)
+  glasses_style: number
+  glasses_color: Colour3
+}
+
+/** One bone segment for the capsule-body renderer. */
+export interface BoneSegment {
+  start: [number, number, number]
+  end: [number, number, number]
+  radius: number
+}
+
+/** Head transform — position + ellipsoid radii. */
+export interface HeadInfo {
+  center: [number, number, number]
+  radius_x: number
+  radius_y: number
+  radius_z: number
+}
+
+/** Style count constants — keep in sync with Rust. */
+export const STYLE_COUNTS = {
+  eye: 12,
+  brow: 8,
+  nose: 8,
+  mouth: 8,
+  hair: 16,
+  facial_hair: 8,
+  glasses: 6,
+} as const