@quake2ts/shared 0.0.1

package/src/io/messageBuilder.ts

@@ -0,0 +1,117 @@
+import { ANORMS } from '../math/anorms.js';
+
+export class NetworkMessageBuilder {
+  private buffer: Uint8Array;
+  private view: DataView;
+  private offset: number;
+
+  constructor(initialSize: number = 1024) {
+    this.buffer = new Uint8Array(initialSize);
+    this.view = new DataView(this.buffer.buffer);
+    this.offset = 0;
+  }
+
+  private ensureCapacity(needed: number): void {
+    if (this.offset + needed > this.buffer.length) {
+      const newSize = Math.max(this.buffer.length * 2, this.offset + needed);
+      const newBuffer = new Uint8Array(newSize);
+      newBuffer.set(this.buffer);
+      this.buffer = newBuffer;
+      this.view = new DataView(this.buffer.buffer);
+    }
+  }
+
+  public getData(): Uint8Array {
+    return this.buffer.slice(0, this.offset);
+  }
+
+  public writeByte(value: number): void {
+    this.ensureCapacity(1);
+    this.view.setUint8(this.offset, value);
+    this.offset += 1;
+  }
+
+  public writeChar(value: number): void {
+    this.ensureCapacity(1);
+    this.view.setInt8(this.offset, value);
+    this.offset += 1;
+  }
+
+  public writeShort(value: number): void {
+    this.ensureCapacity(2);
+    this.view.setInt16(this.offset, value, true);
+    this.offset += 2;
+  }
+
+  public writeUShort(value: number): void {
+      this.ensureCapacity(2);
+      this.view.setUint16(this.offset, value, true);
+      this.offset += 2;
+  }
+
+  public writeLong(value: number): void {
+    this.ensureCapacity(4);
+    this.view.setInt32(this.offset, value, true);
+    this.offset += 4;
+  }
+
+  public writeFloat(value: number): void {
+    this.ensureCapacity(4);
+    this.view.setFloat32(this.offset, value, true);
+    this.offset += 4;
+  }
+
+  public writeString(value: string): void {
+    const len = value.length + 1; // +1 for null terminator
+    this.ensureCapacity(len);
+    for (let i = 0; i < value.length; i++) {
+      this.view.setUint8(this.offset + i, value.charCodeAt(i));
+    }
+    this.view.setUint8(this.offset + value.length, 0);
+    this.offset += len;
+  }
+
+  public writeData(data: Uint8Array): void {
+      this.ensureCapacity(data.length);
+      this.buffer.set(data, this.offset);
+      this.offset += data.length;
+  }
+
+  public writeCoord(value: number): void {
+    this.writeShort(Math.round(value * 8.0));
+  }
+
+  public writeAngle(value: number): void {
+    this.writeByte(Math.round(value * 256.0 / 360.0) & 255);
+  }
+
+  public writeAngle16(value: number): void {
+    this.writeShort(Math.round(value * 65536.0 / 360.0));
+  }
+
+  public writeDir(x: number, y: number, z: number): void {
+      // Find closest normal from ANORMS
+      // Simple brute force or use lookup if needed.
+      // For now, let's just use 0 if implementation is complex to find best match.
+      // Or unimplemented for now?
+      // "WriteDir" in Q2 usually means writing a byte index into ANORMS.
+
+      let best = 0;
+      let bestDot = -999999;
+
+      const len = Math.sqrt(x*x + y*y + z*z);
+      if (len > 0) {
+          x /= len; y /= len; z /= len;
+
+          for (let i=0; i<162; i++) {
+              const dot = x*ANORMS[i][0] + y*ANORMS[i][1] + z*ANORMS[i][2];
+              if (dot > bestDot) {
+                  bestDot = dot;
+                  best = i;
+              }
+          }
+      }
+
+      this.writeByte(best);
+  }
+}

package/src/items/ammo.ts

@@ -0,0 +1,47 @@
+/**
+ * Ammo type identifiers shared across game and cgame.
+ * Reference: rerelease/g_items.cpp, game/src/inventory/ammo.ts
+ */
+
+export enum AmmoType {
+  Bullets = 0,
+  Shells,
+  Rockets,
+  Grenades,
+  Cells,
+  Slugs,
+  // RAFAEL
+  MagSlugs,
+  Trap,
+  // RAFAEL
+  // ROGUE
+  Flechettes,
+  Tesla,
+  Disruptor, // Was missing or named differently?
+  Prox,
+  // ROGUE
+  // Custom or Extras?
+  Nuke,
+  Rounds,
+}
+
+export const AMMO_TYPE_COUNT = Object.keys(AmmoType).length / 2;
+
+/**
+ * Item classnames for ammo pickups.
+ * Used for spawning and identifying ammo items.
+ */
+export enum AmmoItemId {
+  Shells = 'ammo_shells',
+  Bullets = 'ammo_bullets',
+  Rockets = 'ammo_rockets',
+  Grenades = 'ammo_grenades',
+  Cells = 'ammo_cells',
+  Slugs = 'ammo_slugs',
+  MagSlugs = 'ammo_magslug',
+  Flechettes = 'ammo_flechettes',
+  Disruptor = 'ammo_disruptor',
+  Tesla = 'ammo_tesla',
+  Trap = 'ammo_trap',
+  Prox = 'ammo_prox',
+}

package/src/items/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Item enumeration exports for shared use between game and cgame.
+ */
+
+export * from './weapons.js';
+export * from './ammo.js';
+export * from './powerups.js';
+export * from './weaponInfo.js';

package/src/items/powerups.ts

@@ -0,0 +1,32 @@
+/**
+ * Powerup identifiers shared across game and cgame.
+ * Reference: rerelease/g_items.cpp, game/src/inventory/playerInventory.ts
+ */
+
+export enum PowerupId {
+  QuadDamage = 'quad',
+  Invulnerability = 'invulnerability',
+  EnviroSuit = 'enviro_suit',
+  Rebreather = 'rebreather',
+  Silencer = 'silencer',
+  // New additions for demo playback and extended support
+  PowerScreen = 'power_screen',
+  PowerShield = 'power_shield',
+  QuadFire = 'quad_fire',
+  Invisibility = 'invisibility',
+  Bandolier = 'bandolier',
+  AmmoPack = 'ammo_pack',
+  IRGoggles = 'ir_goggles',
+  DoubleDamage = 'double_damage',
+  SphereVengeance = 'sphere_vengeance',
+  SphereHunter = 'sphere_hunter',
+  SphereDefender = 'sphere_defender',
+  Doppelganger = 'doppelganger',
+  TagToken = 'tag_token',
+  TechResistance = 'tech_resistance',
+  TechStrength = 'tech_strength',
+  TechHaste = 'tech_haste',
+  TechRegeneration = 'tech_regeneration',
+  Flashlight = 'flashlight',
+  Compass = 'compass',
+}

package/src/items/weaponInfo.ts

@@ -0,0 +1,45 @@
+import { WeaponId } from './weapons.js';
+import { AmmoType } from './ammo.js';
+
+// Order matches Q2 original weapon wheel index order for bitmask generation
+// Used by both Game (for STAT_WEAPONS_OWNED calculation) and CGame (for weapon wheel UI)
+export const WEAPON_WHEEL_ORDER: WeaponId[] = [
+    WeaponId.Blaster,
+    WeaponId.Shotgun,
+    WeaponId.SuperShotgun,
+    WeaponId.Machinegun,
+    WeaponId.Chaingun,
+    WeaponId.GrenadeLauncher,
+    WeaponId.RocketLauncher,
+    WeaponId.HandGrenade,
+    WeaponId.HyperBlaster,
+    WeaponId.Railgun,
+    WeaponId.BFG10K
+];
+
+// Mapping of weapon to its ammo type
+// Used by CGame to lookup ammo counts for weapon wheel
+export const WEAPON_AMMO_MAP: Record<WeaponId, AmmoType | null> = {
+    [WeaponId.Blaster]: null,
+    [WeaponId.Shotgun]: AmmoType.Shells,
+    [WeaponId.SuperShotgun]: AmmoType.Shells,
+    [WeaponId.Machinegun]: AmmoType.Bullets,
+    [WeaponId.Chaingun]: AmmoType.Bullets,
+    [WeaponId.HandGrenade]: AmmoType.Grenades,
+    [WeaponId.GrenadeLauncher]: AmmoType.Grenades,
+    [WeaponId.RocketLauncher]: AmmoType.Rockets,
+    [WeaponId.HyperBlaster]: AmmoType.Cells,
+    [WeaponId.Railgun]: AmmoType.Slugs,
+    [WeaponId.BFG10K]: AmmoType.Cells,
+
+    // Extensions / Rogue / Xatrix
+    [WeaponId.Grapple]: null,
+    [WeaponId.ChainFist]: null,
+    [WeaponId.EtfRifle]: AmmoType.Flechettes,
+    [WeaponId.ProxLauncher]: AmmoType.Prox,
+    [WeaponId.IonRipper]: AmmoType.Cells,
+    [WeaponId.PlasmaBeam]: AmmoType.Cells,
+    [WeaponId.Phalanx]: AmmoType.MagSlugs,
+    [WeaponId.Disruptor]: AmmoType.Disruptor,
+    [WeaponId.Trap]: AmmoType.Trap,
+};

package/src/items/weapons.ts

@@ -0,0 +1,28 @@
+/**
+ * Weapon identifiers shared across game and cgame.
+ * Reference: rerelease/g_items.cpp, game/src/inventory/playerInventory.ts
+ */
+
+export enum WeaponId {
+  Blaster = 'blaster',
+  Shotgun = 'shotgun',
+  SuperShotgun = 'supershotgun', // Matched to assets (w_supershotgun, weapon_supershotgun)
+  Machinegun = 'machinegun',
+  Chaingun = 'chaingun',
+  HandGrenade = 'grenades', // Matched to assets (w_grenades, weapon_grenades)
+  GrenadeLauncher = 'grenadelauncher', // Matched to assets (w_grenadelauncher)
+  RocketLauncher = 'rocketlauncher', // Matched to assets (w_rocketlauncher)
+  HyperBlaster = 'hyperblaster',
+  Railgun = 'railgun',
+  BFG10K = 'bfg10k',
+  // New additions for demo playback and extended support
+  Grapple = 'grapple',
+  ChainFist = 'chainfist',
+  EtfRifle = 'etf_rifle', // Confirm asset?
+  ProxLauncher = 'prox_launcher', // Confirm asset?
+  IonRipper = 'ionripper',
+  PlasmaBeam = 'plasmabeam',
+  Phalanx = 'phalanx',
+  Disruptor = 'disruptor',
+  Trap = 'trap',
+}

package/src/math/angles.ts

@@ -0,0 +1,135 @@
+import { Vec3 } from './vec3.js';
+
+export const PITCH = 0;
+export const YAW = 1;
+export const ROLL = 2;
+
+const DEG2RAD_FACTOR = Math.PI / 180;
+const RAD2DEG_FACTOR = 180 / Math.PI;
+
+// Export constants for direct use in matrix operations
+export const DEG2RAD = DEG2RAD_FACTOR;
+export const RAD2DEG = RAD2DEG_FACTOR;
+
+function axisComponent(vec: Vec3, axis: number): number {
+  switch (axis) {
+    case PITCH:
+      return vec.x;
+    case YAW:
+      return vec.y;
+    case ROLL:
+    default:
+      return vec.z;
+  }
+}
+
+export interface AngleVectorsResult {
+  readonly forward: Vec3;
+  readonly right: Vec3;
+  readonly up: Vec3;
+}
+
+export function degToRad(degrees: number): number {
+  return degrees * DEG2RAD_FACTOR;
+}
+
+export function radToDeg(radians: number): number {
+  return radians * RAD2DEG_FACTOR;
+}
+
+export function lerpAngle(from: number, to: number, frac: number): number {
+  let target = to;
+
+  if (target - from > 180) {
+    target -= 360;
+  } else if (target - from < -180) {
+    target += 360;
+  }
+
+  return from + frac * (target - from);
+}
+
+export function angleMod(angle: number): number {
+  const value = angle % 360;
+  return value < 0 ? 360 + value : value;
+}
+
+export function angleVectors(angles: Vec3): AngleVectorsResult {
+  const yaw = degToRad(axisComponent(angles, YAW));
+  const pitch = degToRad(axisComponent(angles, PITCH));
+  const roll = degToRad(axisComponent(angles, ROLL));
+
+  const sy = Math.sin(yaw);
+  const cy = Math.cos(yaw);
+  const sp = Math.sin(pitch);
+  const cp = Math.cos(pitch);
+  const sr = Math.sin(roll);
+  const cr = Math.cos(roll);
+
+  const forward: Vec3 = {
+    x: cp * cy,
+    y: cp * sy,
+    z: -sp,
+  };
+
+  const right: Vec3 = {
+    x: -sr * sp * cy - cr * -sy,
+    y: -sr * sp * sy - cr * cy,
+    z: -sr * cp,
+  };
+
+  const up: Vec3 = {
+    x: cr * sp * cy - sr * -sy,
+    y: cr * sp * sy - sr * cy,
+    z: cr * cp,
+  };
+
+  return { forward, right, up };
+}
+
+export function vectorToYaw(vec: Vec3): number {
+  const pitch = axisComponent(vec, PITCH);
+  const yawAxis = axisComponent(vec, YAW);
+
+  if (pitch === 0) {
+    if (yawAxis === 0) {
+      return 0;
+    }
+
+    return yawAxis > 0 ? 90 : 270;
+  }
+
+  const yaw = radToDeg(Math.atan2(yawAxis, pitch));
+  return yaw < 0 ? yaw + 360 : yaw;
+}
+
+export function vectorToAngles(vec: Vec3): Vec3 {
+  const x = vec.x;
+  const y = vec.y;
+  const z = vec.z;
+
+  if (y === 0 && x === 0) {
+    return { x: z > 0 ? -90 : -270, y: 0, z: 0 };
+  }
+
+  let yaw: number;
+  if (x) {
+    yaw = radToDeg(Math.atan2(y, x));
+  } else if (y > 0) {
+    yaw = 90;
+  } else {
+    yaw = 270;
+  }
+
+  if (yaw < 0) {
+    yaw += 360;
+  }
+
+  const forward = Math.sqrt(x * x + y * y);
+  let pitch = radToDeg(Math.atan2(z, forward));
+  if (pitch < 0) {
+    pitch += 360;
+  }
+
+  return { x: -pitch, y: yaw, z: 0 };
+}

package/src/math/anorms.ts

@@ -0,0 +1,165 @@
+// Extracted from full/client/anorms.h
+export const ANORMS: [number, number, number][] = [
+  [-0.525731, 0.000000, 0.850651],
+  [-0.442863, 0.238856, 0.864188],
+  [-0.295242, 0.000000, 0.955423],
+  [-0.309017, 0.500000, 0.809017],
+  [-0.162460, 0.262866, 0.951056],
+  [0.000000, 0.000000, 1.000000],
+  [0.000000, 0.850651, 0.525731],
+  [-0.147621, 0.716567, 0.681718],
+  [0.147621, 0.716567, 0.681718],
+  [0.000000, 0.525731, 0.850651],
+  [0.309017, 0.500000, 0.809017],
+  [0.525731, 0.000000, 0.850651],
+  [0.295242, 0.000000, 0.955423],
+  [0.442863, 0.238856, 0.864188],
+  [0.162460, 0.262866, 0.951056],
+  [-0.681718, 0.147621, 0.716567],
+  [-0.809017, 0.309017, 0.500000],
+  [-0.587785, 0.425325, 0.688191],
+  [-0.850651, 0.525731, 0.000000],
+  [-0.864188, 0.442863, 0.238856],
+  [-0.716567, 0.681718, 0.147621],
+  [-0.688191, 0.587785, 0.425325],
+  [-0.500000, 0.809017, 0.309017],
+  [-0.238856, 0.864188, 0.442863],
+  [-0.425325, 0.688191, 0.587785],
+  [-0.716567, 0.681718, -0.147621],
+  [-0.500000, 0.809017, -0.309017],
+  [-0.525731, 0.850651, 0.000000],
+  [0.000000, 0.850651, -0.525731],
+  [-0.238856, 0.864188, -0.442863],
+  [0.000000, 0.955423, -0.295242],
+  [-0.262866, 0.951056, -0.162460],
+  [0.000000, 1.000000, 0.000000],
+  [0.000000, 0.955423, 0.295242],
+  [-0.262866, 0.951056, 0.162460],
+  [0.238856, 0.864188, 0.442863],
+  [0.262866, 0.951056, 0.162460],
+  [0.500000, 0.809017, 0.309017],
+  [0.238856, 0.864188, -0.442863],
+  [0.262866, 0.951056, -0.162460],
+  [0.500000, 0.809017, -0.309017],
+  [0.850651, 0.525731, 0.000000],
+  [0.716567, 0.681718, 0.147621],
+  [0.716567, 0.681718, -0.147621],
+  [0.525731, 0.850651, 0.000000],
+  [0.425325, 0.688191, 0.587785],
+  [0.864188, 0.442863, 0.238856],
+  [0.688191, 0.587785, 0.425325],
+  [0.809017, 0.309017, 0.500000],
+  [0.681718, 0.147621, 0.716567],
+  [0.587785, 0.425325, 0.688191],
+  [0.955423, 0.295242, 0.000000],
+  [1.000000, 0.000000, 0.000000],
+  [0.951056, 0.162460, 0.262866],
+  [0.850651, -0.525731, 0.000000],
+  [0.955423, -0.295242, 0.000000],
+  [0.864188, -0.442863, 0.238856],
+  [0.951056, -0.162460, 0.262866],
+  [0.809017, -0.309017, 0.500000],
+  [0.681718, -0.147621, 0.716567],
+  [0.850651, 0.000000, 0.525731],
+  [0.864188, 0.442863, -0.238856],
+  [0.809017, 0.309017, -0.500000],
+  [0.951056, 0.162460, -0.262866],
+  [0.525731, 0.000000, -0.850651],
+  [0.681718, 0.147621, -0.716567],
+  [0.681718, -0.147621, -0.716567],
+  [0.850651, 0.000000, -0.525731],
+  [0.809017, -0.309017, -0.500000],
+  [0.864188, -0.442863, -0.238856],
+  [0.951056, -0.162460, -0.262866],
+  [0.147621, 0.716567, -0.681718],
+  [0.309017, 0.500000, -0.809017],
+  [0.425325, 0.688191, -0.587785],
+  [0.442863, 0.238856, -0.864188],
+  [0.587785, 0.425325, -0.688191],
+  [0.688191, 0.587785, -0.425325],
+  [-0.147621, 0.716567, -0.681718],
+  [-0.309017, 0.500000, -0.809017],
+  [0.000000, 0.525731, -0.850651],
+  [-0.525731, 0.000000, -0.850651],
+  [-0.442863, 0.238856, -0.864188],
+  [-0.295242, 0.000000, -0.955423],
+  [-0.162460, 0.262866, -0.951056],
+  [0.000000, 0.000000, -1.000000],
+  [0.295242, 0.000000, -0.955423],
+  [0.162460, 0.262866, -0.951056],
+  [-0.442863, -0.238856, -0.864188],
+  [-0.309017, -0.500000, -0.809017],
+  [-0.162460, -0.262866, -0.951056],
+  [0.000000, -0.850651, -0.525731],
+  [-0.147621, -0.716567, -0.681718],
+  [0.147621, -0.716567, -0.681718],
+  [0.000000, -0.525731, -0.850651],
+  [0.309017, -0.500000, -0.809017],
+  [0.442863, -0.238856, -0.864188],
+  [0.162460, -0.262866, -0.951056],
+  [0.238856, -0.864188, -0.442863],
+  [0.500000, -0.809017, -0.309017],
+  [0.425325, -0.688191, -0.587785],
+  [0.716567, -0.681718, -0.147621],
+  [0.688191, -0.587785, -0.425325],
+  [0.587785, -0.425325, -0.688191],
+  [0.000000, -0.955423, -0.295242],
+  [0.000000, -1.000000, 0.000000],
+  [0.262866, -0.951056, -0.162460],
+  [0.000000, -0.850651, 0.525731],
+  [0.000000, -0.955423, 0.295242],
+  [0.238856, -0.864188, 0.442863],
+  [0.262866, -0.951056, 0.162460],
+  [0.500000, -0.809017, 0.309017],
+  [0.716567, -0.681718, 0.147621],
+  [0.525731, -0.850651, 0.000000],
+  [-0.238856, -0.864188, -0.442863],
+  [-0.500000, -0.809017, -0.309017],
+  [-0.262866, -0.951056, -0.162460],
+  [-0.850651, -0.525731, 0.000000],
+  [-0.716567, -0.681718, -0.147621],
+  [-0.716567, -0.681718, 0.147621],
+  [-0.525731, -0.850651, 0.000000],
+  [-0.500000, -0.809017, 0.309017],
+  [-0.238856, -0.864188, 0.442863],
+  [-0.262866, -0.951056, 0.162460],
+  [-0.864188, -0.442863, 0.238856],
+  [-0.809017, -0.309017, 0.500000],
+  [-0.688191, -0.587785, 0.425325],
+  [-0.681718, -0.147621, 0.716567],
+  [-0.442863, -0.238856, 0.864188],
+  [-0.587785, -0.425325, 0.688191],
+  [-0.309017, -0.500000, 0.809017],
+  [-0.147621, -0.716567, 0.681718],
+  [-0.425325, -0.688191, 0.587785],
+  [-0.162460, -0.262866, 0.951056],
+  [0.442863, -0.238856, 0.864188],
+  [0.162460, -0.262866, 0.951056],
+  [0.309017, -0.500000, 0.809017],
+  [0.147621, -0.716567, 0.681718],
+  [0.000000, -0.525731, 0.850651],
+  [0.425325, -0.688191, 0.587785],
+  [0.587785, -0.425325, 0.688191],
+  [0.688191, -0.587785, 0.425325],
+  [-0.955423, 0.295242, 0.000000],
+  [-0.951056, 0.162460, 0.262866],
+  [-1.000000, 0.000000, 0.000000],
+  [-0.850651, 0.000000, 0.525731],
+  [-0.955423, -0.295242, 0.000000],
+  [-0.951056, -0.162460, 0.262866],
+  [-0.864188, 0.442863, -0.238856],
+  [-0.951056, 0.162460, -0.262866],
+  [-0.809017, 0.309017, -0.500000],
+  [-0.864188, -0.442863, -0.238856],
+  [-0.951056, -0.162460, -0.262866],
+  [-0.809017, -0.309017, -0.500000],
+  [-0.681718, 0.147621, -0.716567],
+  [-0.681718, -0.147621, -0.716567],
+  [-0.850651, 0.000000, -0.525731],
+  [-0.688191, 0.587785, -0.425325],
+  [-0.587785, 0.425325, -0.688191],
+  [-0.425325, 0.688191, -0.587785],
+  [-0.425325, -0.688191, -0.587785],
+  [-0.587785, -0.425325, -0.688191],
+  [-0.688191, -0.587785, -0.425325]
+];

package/src/math/color.ts

@@ -0,0 +1,42 @@
+export type Color4 = [number, number, number, number];
+
+/**
+ * TypeScript port of G_AddBlend from rerelease q_std.h.
+ *
+ * Given an incoming RGBA color and an existing blend color, computes the new
+ * blended color where alpha is accumulated and RGB is mixed proportionally
+ * to the previous vs. new alpha contribution.
+ *
+ * This function is pure and does not mutate its inputs.
+ */
+export function addBlendColor(
+  r: number,
+  g: number,
+  b: number,
+  a: number,
+  current: Color4,
+): Color4 {
+  if (a <= 0) {
+    return current;
+  }
+
+  const oldR = current[0];
+  const oldG = current[1];
+  const oldB = current[2];
+  const oldA = current[3];
+
+  const a2 = oldA + (1 - oldA) * a;
+
+  if (a2 <= 0) {
+    return [0, 0, 0, 0];
+  }
+
+  const a3 = oldA / a2;
+
+  const newR = oldR * a3 + r * (1 - a3);
+  const newG = oldG * a3 + g * (1 - a3);
+  const newB = oldB * a3 + b * (1 - a3);
+
+  return [newR, newG, newB, a2];
+}
+

package/src/math/mat4.ts

@@ -0,0 +1,58 @@
+import { Vec3 } from './vec3.js';
+
+export type Mat4 = Float32Array;
+
+export function createMat4Identity(): Mat4 {
+  return new Float32Array([
+    1, 0, 0, 0,
+    0, 1, 0, 0,
+    0, 0, 1, 0,
+    0, 0, 0, 1,
+  ]);
+}
+
+export function multiplyMat4(a: Float32Array, b: Float32Array): Mat4 {
+  const out = new Float32Array(16);
+  for (let row = 0; row < 4; row += 1) {
+    for (let col = 0; col < 4; col += 1) {
+      out[col * 4 + row] =
+        a[0 * 4 + row] * b[col * 4 + 0] +
+        a[1 * 4 + row] * b[col * 4 + 1] +
+        a[2 * 4 + row] * b[col * 4 + 2] +
+        a[3 * 4 + row] * b[col * 4 + 3];
+    }
+  }
+  return out;
+}
+
+export function transformPointMat4(mat: Float32Array, point: Vec3): Vec3 {
+  const x = point.x;
+  const y = point.y;
+  const z = point.z;
+  return {
+    x: mat[0] * x + mat[4] * y + mat[8] * z + mat[12],
+    y: mat[1] * x + mat[5] * y + mat[9] * z + mat[13],
+    z: mat[2] * x + mat[6] * y + mat[10] * z + mat[14],
+  };
+}
+
+export function mat4FromBasis(origin: Vec3, axis: readonly [Vec3, Vec3, Vec3]): Mat4 {
+  const out = createMat4Identity();
+  out[0] = axis[0].x;
+  out[1] = axis[0].y;
+  out[2] = axis[0].z;
+
+  out[4] = axis[1].x;
+  out[5] = axis[1].y;
+  out[6] = axis[1].z;
+
+  out[8] = axis[2].x;
+  out[9] = axis[2].y;
+  out[10] = axis[2].z;
+
+  out[12] = origin.x;
+  out[13] = origin.y;
+  out[14] = origin.z;
+
+  return out;
+}