@plasius/game-audio-spatial

Spatial acoustic obstruction and occlusion contracts for Plasius game audio.

Apache-2.0. ESM + CJS builds. TypeScript types included.

Installation

npm install @plasius/game-audio-spatial

Scope

This repository is part of the Plasius in-game audio package suite.

It owns:

• listener and emitter pose contracts
• acoustic material and obstacle profiles
• deterministic obstruction estimates for gain, low-pass, spread, and hard-clip hints
• adapter boundaries for scene and physics integrations

It does not own game-world authority, speech provider credentials, raw TTS generation, or product-specific feature-flag evaluation.

Feature Flag

• game.audio.sfx-occlusion.enabled

Usage

import {
  packageDescriptor,
  GAME_AUDIO_SPATIAL_PACKAGE,
  GAME_AUDIO_SPATIAL_FEATURE_FLAG_ID,
} from "@plasius/game-audio-spatial";

console.log(packageDescriptor.packageName === GAME_AUDIO_SPATIAL_PACKAGE);
console.log(packageDescriptor.featureFlagId === GAME_AUDIO_SPATIAL_FEATURE_FLAG_ID);

Development

npm install
npm run build
npm test
npm run test:coverage
npm run pack:check

Governance

• Architecture decisions: docs/adrs
• Security policy: SECURITY.md
• Code of conduct: CODE_OF_CONDUCT.md
• CLA and legal docs: legal

License

Apache-2.0

Release integrity

Production package publication runs only from .github/workflows/cd.yml on protected main. The job verifies that the prepared commit is still the current main commit and has an exact successful ci.yml push result before it mutates release state. Public package CI runs on GitHub-hosted capacity so it cannot execute on company-managed runners. npm publication runs on GitHub-hosted Node.js 24 with npm 11.5.1 or newer, uses the protected production environment and short-lived npm OIDC with provenance, and has no long-lived npm write-token fallback. Rollback disables CD; it never rewrites published package history.