blecsd 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013-2015, Christopher Jeffrey and contributors
+https://github.com/chjj/
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,220 @@
+# blECSd
+
+[![CI](https://github.com/Kadajett/blECSd/actions/workflows/ci.yml/badge.svg)](https://github.com/Kadajett/blECSd/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/blecsd.svg)](https://www.npmjs.com/package/blecsd)
+
+A high-performance terminal UI library built on TypeScript and bitECS.
+
+blECSd provides a complete toolkit for building terminal applications: dashboards, file managers, system monitors, CLI tools, and games. It combines the performance of an Entity Component System with production-ready widgets and form controls.
+
+## Features
+
+- **18 Widgets**: Box, Panel, Tabs, List, Table, Tree, VirtualizedList, and more
+- **Form Controls**: TextInput, Checkbox, RadioButton, Slider, Select, ProgressBar
+- **32 Components**: Position, Renderable, Focusable, Interactive, Animation, Collision, etc.
+- **12 Systems**: Layout, Input, Render, Animation, Collision, Camera, Drag, Focus, etc.
+- **Physics-based Animations**: Velocity, acceleration, friction for smooth transitions
+- **Virtualized Rendering**: Efficiently render 1000s of items
+- **State Machines**: Built-in FSM support for complex UI state
+
+## Install
+
+```bash
+npm install blecsd
+```
+
+## Quick Start
+
+```typescript
+import { createWorld, addEntity } from 'bitecs';
+import {
+  setPosition,
+  setDimensions,
+  setBorder,
+  setContent,
+  createPanel,
+  createList,
+  createTextInput,
+  createEventBus
+} from 'blecsd';
+
+// Create a world and entities
+const world = createWorld();
+
+// Create a panel with a title
+const panel = createPanel(world, {
+  x: 2,
+  y: 1,
+  width: 40,
+  height: 10,
+  title: 'My Application',
+  border: { type: 'rounded' }
+});
+
+// Create an interactive list
+const list = createList(world, {
+  x: 4,
+  y: 3,
+  width: 36,
+  height: 6,
+  items: [
+    { label: 'Option 1', value: 'opt1' },
+    { label: 'Option 2', value: 'opt2' },
+    { label: 'Option 3', value: 'opt3' }
+  ]
+});
+
+// Type-safe events
+interface AppEvents {
+  'item:selected': { value: string };
+}
+const events = createEventBus<AppEvents>();
+events.on('item:selected', (e) => console.log(`Selected: ${e.value}`));
+```
+
+## Widgets
+
+| Widget | Description |
+|--------|-------------|
+| Box | Base container with borders, padding, content |
+| Panel | Box with title bar, collapsible, close button |
+| Tabs | Tabbed container with keyboard navigation |
+| Text | Text display with alignment, wrapping |
+| List | Selectable list with keyboard/mouse support |
+| Table | Data table with headers, columns, sorting |
+| Tree | Hierarchical tree view with expand/collapse |
+| VirtualizedList | Efficient list for large datasets |
+| ListTable | Table-style list display |
+| Listbar | Horizontal navigation bar |
+| Line | Horizontal/vertical separator |
+| Loading | Loading indicator with spinner |
+| ScrollableBox | Container with scroll support |
+| ScrollableText | Scrollable text area |
+| HoverText | Tooltip/hover text display |
+| Layout | Flex/grid layout container |
+
+## Form Controls
+
+| Control | Description |
+|---------|-------------|
+| TextInput | Single/multi-line text entry with cursor, selection |
+| Checkbox | Boolean toggle with customizable characters |
+| RadioButton | Single selection from group |
+| Slider | Range value selection, horizontal/vertical |
+| Select | Dropdown selection menu |
+| ProgressBar | Progress indicator, horizontal/vertical |
+| Form | Form field management, validation, submit |
+
+## Components
+
+blECSd provides ECS components that work with any bitECS world:
+
+| Component | Purpose |
+|-----------|---------|
+| Position | X/Y coordinates, z-index, absolute positioning |
+| Renderable | Colors, visibility, dirty tracking |
+| Dimensions | Width, height, min/max constraints, percentages |
+| Hierarchy | Parent-child relationships, traversal |
+| Focusable | Keyboard focus, tab order |
+| Interactive | Click, hover, drag states |
+| Scrollable | Scroll position, content size, scrollbars |
+| Border | Box borders (single, double, rounded, bold, ascii) |
+| Content | Text content, alignment, wrapping, tag parsing |
+| Padding | Inner spacing |
+| Label | Text labels with positioning |
+| Animation | Frame-based sprite animations |
+| Velocity | Movement with speed, friction, max speed |
+| Collision | AABB/circle collision detection, layers, triggers |
+| Camera | Viewport, target following, bounds |
+| StateMachine | Finite state machine with events, transitions |
+| Sprite | Sprite sheets, frames |
+| Shadow | Drop shadows with opacity, blending |
+| VirtualViewport | Virtualized content rendering |
+
+See [API Reference](./docs/api/index.md) for the complete list.
+
+## Systems
+
+| System | Purpose |
+|--------|---------|
+| inputSystem | Process keyboard/mouse input |
+| focusSystem | Manage focus, tab navigation |
+| layoutSystem | Calculate positions, dimensions |
+| renderSystem | Render entities to screen buffer |
+| virtualizedRenderSystem | Efficient rendering for large datasets |
+| animationSystem | Update sprite animations |
+| movementSystem | Apply velocity to position |
+| collisionSystem | Detect and resolve collisions |
+| cameraSystem | Update camera following target |
+| dragSystem | Handle drag and drop |
+| stateMachineSystem | Process state machine transitions |
+| outputSystem | Write buffer to terminal |
+
+## Library Design
+
+blECSd is a library, not a framework:
+
+1. **Components work standalone**: Import them into any bitECS world
+2. **No required update loop**: All systems are callable functions
+3. **Mix and match**: Use our input parsing with your rendering, or vice versa
+4. **You own the world**: Functions take `world` as a parameter; we never hold global state
+
+```typescript
+// Your world, your control
+import { createWorld, addEntity } from 'bitecs';
+import { setPosition, setRenderable, layoutSystem, renderSystem } from 'blecsd';
+
+const world = createWorld();
+const eid = addEntity(world);
+
+// Use components without our update loop
+setPosition(world, eid, 10, 5);
+
+// Call systems when you want
+layoutSystem(world);
+renderSystem(world);
+```
+
+## Use Cases
+
+- **Dashboards**: System monitors, log viewers, status displays
+- **File Managers**: Tree views, virtualized lists, panels
+- **CLI Tools**: Forms, menus, progress indicators
+- **Dev Tools**: Debug panels, profilers, inspectors
+- **Games**: Roguelikes, text adventures, puzzle games
+
+## Comparison
+
+| Feature | blECSd | Ink | blessed | Textual |
+|---------|--------|-----|---------|---------|
+| Architecture | ECS (data-oriented) | React (component) | Class-based | Widget classes |
+| Language | TypeScript | TypeScript/JSX | JavaScript | Python |
+| Widgets | 18 built-in | Few built-in | Many built-in | Many built-in |
+| Animation | Physics-based | Manual | Manual | CSS-like |
+| Virtualization | Built-in | Manual | Manual | Built-in |
+| Game support | First-class | Limited | Limited | Limited |
+
+Choose blECSd if you want data-oriented design, physics-based animations, or game development support. Choose Ink for React-style development. Choose Textual for Python projects.
+
+## Documentation
+
+- [Installation](./docs/getting-started/installation.md): Requirements, terminal compatibility, setup
+- [Core Concepts](./docs/getting-started/concepts.md): ECS, scheduler, events
+- [Hello World](./docs/getting-started/hello-world.md): Your first blECSd application
+- [API Reference](./docs/api/index.md): Components, widgets, systems, terminal I/O
+- [Terminal Widget](./docs/api/widgets/terminal.md): ANSI rendering and PTY shell support
+- [Examples](./docs/examples/index.md): File manager, multiplexer, system monitor, ANSI viewer, telnet server
+- [Guides](./docs/guides/): Animations, forms, layouts, and more
+
+## Development
+
+```bash
+pnpm install
+pnpm test
+pnpm lint
+pnpm build
+```
+
+## License
+
+MIT

package/dist/3d/index.d.ts

@@ -0,0 +1,5 @@
+export { A as AmbientLight, a as AmbientLightSchema, b as Animation3D, c as Animation3DData, B as BackendCapabilities, d as BackendCapabilitiesSchema, e as BackendPreference, f as BackendPreferenceSchema, g as BackendSelection, h as BackendSelectionSchema, j as BackendType, k as BackendTypeSchema, l as BrailleConfig, m as BrailleConfigSchema, C as Camera3D, n as Camera3DData, o as ClipRect, p as ClipRectSchema, q as ClippedLine, r as CubeMeshOptions, s as CubeMeshOptionsSchema, t as CylinderMeshOptions, u as CylinderMeshOptionsSchema, D as DirectionalLight, v as DirectionalLightSchema, E as EncodedCell, w as EncodedCellSchema, x as EncodedOutput, y as EncodedOutputSchema, z as EulerAngles, F as EulerAnglesSchema, G as FrustumPlane, H as GraphicsCapabilities, I as HalfBlockConfig, J as HalfBlockConfigSchema, K as KittyConfig, L as KittyConfigSchema, M as LineEndpoint, N as LineEndpointSchema, O as Mat4, P as Mat4Schema, Q as Material3D, R as Material3DData, S as Mesh, T as MeshData, U as MeshProjection, V as MouseDragInput, W as MouseInteraction3D, X as MouseInteraction3DData, Y as ObjFace, Z as ObjGroup, _ as ObjLoadOptions, $ as ObjLoadOptionsSchema, a0 as ObjParseResult, a1 as ObjVertex, a2 as OrthographicConfig, a3 as OrthographicConfigSchema, a4 as PerspectiveConfig, a5 as PerspectiveConfigSchema, a6 as PixelBufferConfig, a7 as PixelBufferConfigSchema, a8 as PixelFramebuffer, a9 as PlaneMeshOptions, aa as PlaneMeshOptionsSchema, ab as ProjectedVertex, ac as RGBAColor, ad as RGBAColorSchema, ae as RendererBackend, af as ScreenCoord, ag as SextantConfig, ah as SextantConfigSchema, ai as SixelConfig, aj as SixelConfigSchema, ak as SphereMeshOptions, al as SphereMeshOptionsSchema, am as Transform3D, an as Transform3DData, ao as TriangleBBox, ap as TriangleVertex, aq as TriangleVertexSchema, ar as Vec3, as as Vec3Input, at as Vec3InputSchema, au as Vec3Schema, av as Viewport3D, aw as Viewport3DData, ax as ViewportConfig, ay as ViewportConfigSchema, az as ViewportOutput, aA as ViewportProjection, aB as animation3DSystem, aC as backendStore, aD as blendPixel, aE as buildMVP, aF as clearBackendStore, aG as clearFramebuffer, aH as clearFramebufferStore, aI as clearMeshStore, aJ as clearMouseInputStore, aK as clearOutputStore, aL as clearProjectionStore, aM as clipLine, aN as computeBoundingBox, aO as computeFaceNormal, aP as computeFlatShading, aQ as computeOutcode, aR as createBackendByType, aS as createBrailleBackend, aT as createCubeMesh, aU as createCylinderMesh, aV as createHalfBlockBackend, aW as createKittyBackend, aX as createMeshFromArrays, aY as createPixelFramebuffer, aZ as createPlaneMesh, a_ as createSextantBackend, a$ as createSixelBackend, b0 as createSphereMesh, b1 as detectBestBackend, b2 as disableMouseInteraction, b3 as drawLine, b4 as drawLineAA, b5 as drawLineColor, b6 as drawLineDepth, b7 as enableMouseInteraction, b8 as extractFrustumPlanes, b9 as feedMouseDrag, ba as feedMouseScroll, bb as fillRect, bc as fillTriangle, bd as fillTriangleFlat, be as framebufferStore, bf as getAnimation3D, bg as getCamera3D, bh as getDepth, bi as getMaterial3D, bj as getMesh, bk as getMeshCount, bl as getMeshData, bm as getMouseInteraction3D, bn as getPixel, bo as getProjMatrix, bp as getTransform3D, bq as getViewMatrix, br as getViewport3D, bs as getWorldMatrix, bt as isDirty, bu as isInBounds, bv as isPointInFrustum, bw as isSphereInFrustum, bx as loadObjAsMesh, by as lookAt, bz as markDirty, bA as mat4Determinant, bB as mat4Equals, bC as mat4FromTRS, bD as mat4Identity, bE as mat4Invert, bF as mat4IsIdentity, bG as mat4Multiply, bH as mat4RotateX, bI as mat4RotateY, bJ as mat4RotateZ, bK as mat4Scale, bL as mat4TransformDirection, bM as mat4TransformVec3, bN as mat4Translate, bO as mat4Transpose, bP as mouseInputStore, bQ as mouseInteraction3DSystem, bR as orthographicMatrix, bS as outputStore, bT as parseObj, bU as perspectiveMatrix, bV as projectVertex, bW as projectionStore, bX as projectionSystem, bY as rasterSystem, bZ as registerMesh, b_ as sceneGraphSystem, b$ as setAnimation3D, c0 as setCamera3D, c1 as setMaterial3D, c2 as setMesh, c3 as setPixel, c4 as setPixelUnsafe, c5 as setRotation, c6 as setScale, c7 as setTransform3D, c8 as setTranslation, c9 as setViewport3D, ca as shadeFace, cb as testAndSetDepth, cc as triangleArea2, cd as triangleBoundingBox, ce as unprojectVertex, cf as unregisterMesh, cg as vec3, ch as vec3Add, ci as vec3Cross, cj as vec3Distance, ck as vec3Dot, cl as vec3Equals, cm as vec3FromArray, cn as vec3Length, co as vec3LengthSq, cp as vec3Lerp, cq as vec3Negate, cr as vec3Normalize, cs as vec3Scale, ct as vec3Sub, cu as vec3Zero, cv as viewportOutputSystem, cw as viewportTransform } from '../index-zSGJ2eUk.js';
+export { A as Animation3DConfig, b as Animation3DConfigSchema, C as Camera3DConfig, c as Camera3DConfigSchema, M as Material3DConfig, d as Material3DConfigSchema, a as MouseInteraction3DConfig, e as MouseInteraction3DConfigSchema, T as Transform3DConfig, f as Transform3DConfigSchema, V as Viewport3DConfig, g as Viewport3DConfigSchema, h as Viewport3DWidgetConfig, i as Viewport3DWidgetConfigSchema } from '../viewport3d-xI33-_wq.js';
+import 'zod';
+import '../types-BcsvoKzf.js';
+import 'bitecs';

package/dist/3d/index.js

@@ -0,0 +1 @@
+export{a as Animation3D,m as CubeMeshOptionsSchema,p as CylinderMeshOptionsSchema,d as MouseInteraction3D,l as ObjLoadOptionsSchema,o as PlaneMeshOptionsSchema,n as SphereMeshOptionsSchema,H as animation3DSystem,K as backendStore,y as blendPixel,M as clearBackendStore,f as clearMouseInputStore,N as clearOutputStore,u as clipLine,r as computeBoundingBox,A as computeFaceNormal,B as computeFlatShading,t as computeOutcode,D as createCubeMesh,G as createCylinderMesh,F as createPlaneMesh,E as createSphereMesh,j as disableMouseInteraction,z as drawLineAA,i as enableMouseInteraction,v as extractFrustumPlanes,g as feedMouseDrag,h as feedMouseScroll,c as getAnimation3D,k as getMouseInteraction3D,w as isPointInFrustum,x as isSphereInFrustum,s as loadObjAsMesh,e as mouseInputStore,I as mouseInteraction3DSystem,L as outputStore,q as parseObj,J as sceneGraphSystem,b as setAnimation3D,C as shadeFace,O as viewportOutputSystem}from'../chunk-VNZ6CWJA.js';export{Xa as AmbientLightSchema,w as Animation3DConfigSchema,b as BackendCapabilitiesSchema,k as BackendPreferenceSchema,e as BackendSelectionSchema,a as BackendTypeSchema,f as BrailleConfigSchema,y as Camera3D,t as Camera3DConfigSchema,ga as ClipRectSchema,Wa as DirectionalLightSchema,c as EncodedCellSchema,d as EncodedOutputSchema,ca as EulerAnglesSchema,g as HalfBlockConfigSchema,j as KittyConfigSchema,Ta as LineEndpointSchema,ba as Mat4Schema,D as Material3D,u as Material3DConfigSchema,G as Mesh,x as MouseInteraction3DConfigSchema,ea as OrthographicConfigSchema,da as PerspectiveConfigSchema,Sa as PixelBufferConfigSchema,Ua as RGBAColorSchema,h as SextantConfigSchema,i as SixelConfigSchema,P as Transform3D,s as Transform3DConfigSchema,Va as TriangleVertexSchema,aa as Vec3InputSchema,$ as Vec3Schema,Y as Viewport3D,v as Viewport3DConfigSchema,mb as Viewport3DWidgetConfigSchema,fa as ViewportConfigSchema,Ra as buildMVP,Za as clearFramebuffer,rb as clearFramebufferStore,O as clearMeshStore,ob as clearProjectionStore,q as createBackendByType,l as createBrailleBackend,m as createHalfBlockBackend,n as createKittyBackend,I as createMeshFromArrays,Ya as createPixelFramebuffer,o as createSextantBackend,p as createSixelBackend,r as detectBestBackend,fb as drawLine,hb as drawLineColor,gb as drawLineDepth,eb as fillRect,kb as fillTriangle,lb as fillTriangleFlat,qb as framebufferStore,A as getCamera3D,cb as getDepth,F as getMaterial3D,M as getMesh,N as getMeshCount,J as getMeshData,$a as getPixel,B as getProjMatrix,R as getTransform3D,C as getViewMatrix,_ as getViewport3D,V as getWorldMatrix,X as isDirty,_a as isInBounds,Na as lookAt,W as markDirty,Ea as mat4Determinant,Ka as mat4Equals,Ia as mat4FromTRS,wa as mat4Identity,Fa as mat4Invert,Ja as mat4IsIdentity,xa as mat4Multiply,za as mat4RotateX,Aa as mat4RotateY,Ba as mat4RotateZ,Ca as mat4Scale,Ha as mat4TransformDirection,Ga as mat4TransformVec3,ya as mat4Translate,Da as mat4Transpose,Ma as orthographicMatrix,La as perspectiveMatrix,Pa as projectVertex,nb as projectionStore,pb as projectionSystem,sb as rasterSystem,H as registerMesh,z as setCamera3D,E as setMaterial3D,L as setMesh,ab as setPixel,bb as setPixelUnsafe,T as setRotation,U as setScale,Q as setTransform3D,S as setTranslation,Z as setViewport3D,db as testAndSetDepth,ib as triangleArea2,jb as triangleBoundingBox,Qa as unprojectVertex,K as unregisterMesh,ha as vec3,ja as vec3Add,na as vec3Cross,ta as vec3Distance,ma as vec3Dot,ua as vec3Equals,ia as vec3FromArray,pa as vec3Length,oa as vec3LengthSq,ra as vec3Lerp,sa as vec3Negate,qa as vec3Normalize,la as vec3Scale,ka as vec3Sub,va as vec3Zero,Oa as viewportTransform}from'../chunk-LYSK5S63.js';import'../chunk-H2YAOJDW.js';import'../chunk-G7GIWWLE.js';import'../chunk-PXXGH3BV.js';import'../chunk-5PELJRUQ.js';

package/dist/audio/index.d.ts

@@ -0,0 +1,177 @@
+import { b as EventMap, E as EventBus } from '../events-BbbxkgvX.js';
+import { U as Unsubscribe } from '../types-BcsvoKzf.js';
+import 'bitecs';
+
+/**
+ * Audio integration hooks for games.
+ *
+ * Provides typed interfaces and hook functions for integrating audio
+ * into terminal games. blECSd does not play audio directly; instead,
+ * users supply an AudioAdapter implementation and the library wires
+ * event-based sound triggers, volume control, and channel management.
+ *
+ * @module audio/hooks
+ */
+
+/**
+ * Audio channel for routing sounds.
+ */
+declare const AudioChannel: {
+    readonly Music: 0;
+    readonly SFX: 1;
+};
+type AudioChannelValue = (typeof AudioChannel)[keyof typeof AudioChannel];
+/**
+ * Options for playing a sound.
+ *
+ * @example
+ * ```typescript
+ * import { AudioChannel } from 'blecsd';
+ *
+ * const options: PlayOptions = {
+ *   id: 'explosion',
+ *   loop: false,
+ *   volume: 0.8,
+ *   channel: AudioChannel.SFX,
+ * };
+ * ```
+ */
+interface PlayOptions {
+    /** Unique identifier for the sound */
+    readonly id: string;
+    /** Whether the sound should loop (default: false) */
+    readonly loop?: boolean;
+    /** Volume level from 0 to 1 (default: 1) */
+    readonly volume?: number;
+    /** Audio channel to play on (default: AudioChannel.SFX) */
+    readonly channel?: AudioChannelValue;
+}
+/**
+ * User-provided audio adapter that handles actual audio playback.
+ * blECSd never plays audio directly; this interface is what users implement.
+ *
+ * @example
+ * ```typescript
+ * import type { AudioAdapter } from 'blecsd';
+ *
+ * const myAudio: AudioAdapter = {
+ *   play: (opts) => { console.log(`Playing ${opts.id}`); },
+ *   stop: (id) => { console.log(`Stopping ${id}`); },
+ *   stopAll: () => { console.log('Stopping all'); },
+ *   setVolume: (channel, volume) => { ... },
+ *   setMuted: (channel, muted) => { ... },
+ * };
+ * ```
+ */
+interface AudioAdapter {
+    /** Play a sound with the given options */
+    play(options: PlayOptions): void;
+    /** Stop a specific sound by its ID */
+    stop(id: string): void;
+    /** Stop all currently playing sounds */
+    stopAll(): void;
+    /** Set the volume for a channel (0 to 1) */
+    setVolume(channel: AudioChannelValue, volume: number): void;
+    /** Mute or unmute a channel */
+    setMuted(channel: AudioChannelValue, muted: boolean): void;
+}
+/**
+ * A sound trigger that maps an event to a sound.
+ */
+interface SoundTrigger<T extends EventMap, K extends keyof T> {
+    /** The event name to listen for */
+    readonly event: K;
+    /** The sound ID to play when the event fires */
+    readonly soundId: string;
+    /** Optional play options override */
+    readonly options?: Omit<PlayOptions, 'id'>;
+    /** Optional predicate to conditionally trigger the sound */
+    readonly when?: (payload: T[K]) => boolean;
+}
+/**
+ * Audio manager state.
+ */
+interface AudioState {
+    readonly musicVolume: number;
+    readonly sfxVolume: number;
+    readonly musicMuted: boolean;
+    readonly sfxMuted: boolean;
+    readonly adapter: AudioAdapter | undefined;
+}
+/**
+ * Audio manager returned by createAudioManager.
+ */
+interface AudioManager {
+    /** Get current audio state */
+    getState(): AudioState;
+    /** Set the audio adapter implementation */
+    setAdapter(adapter: AudioAdapter): void;
+    /** Remove the current adapter */
+    clearAdapter(): void;
+    /** Play a sound */
+    play(options: PlayOptions): void;
+    /** Play a sound by ID with default options */
+    playSound(id: string, channel?: AudioChannelValue): void;
+    /** Play background music (loops by default) */
+    playMusic(id: string, volume?: number): void;
+    /** Stop a specific sound */
+    stop(id: string): void;
+    /** Stop all sounds */
+    stopAll(): void;
+    /** Set volume for a channel (0 to 1) */
+    setVolume(channel: AudioChannelValue, volume: number): void;
+    /** Get volume for a channel */
+    getVolume(channel: AudioChannelValue): number;
+    /** Mute a channel */
+    mute(channel: AudioChannelValue): void;
+    /** Unmute a channel */
+    unmute(channel: AudioChannelValue): void;
+    /** Toggle mute for a channel */
+    toggleMute(channel: AudioChannelValue): void;
+    /** Check if a channel is muted */
+    isMuted(channel: AudioChannelValue): boolean;
+    /** Register a sound trigger for an event bus */
+    onEvent<T extends EventMap, K extends keyof T>(bus: EventBus<T>, trigger: SoundTrigger<T, K>): Unsubscribe;
+    /** Register multiple sound triggers at once */
+    onEvents<T extends EventMap>(bus: EventBus<T>, triggers: ReadonlyArray<SoundTrigger<T, keyof T>>): Unsubscribe;
+    /** Destroy the audio manager and clean up */
+    destroy(): void;
+}
+/**
+ * Creates an audio manager for integrating sound into a game.
+ *
+ * The manager does not play audio directly. Instead, users provide an
+ * AudioAdapter that handles actual playback. The manager handles
+ * channel volumes, muting, and event-based sound triggers.
+ *
+ * @param adapter - Optional initial audio adapter
+ * @returns An AudioManager instance
+ *
+ * @example
+ * ```typescript
+ * import { createAudioManager, AudioChannel } from 'blecsd';
+ *
+ * const audio = createAudioManager();
+ *
+ * // Set an adapter (user-provided audio implementation)
+ * audio.setAdapter(myAudioAdapter);
+ *
+ * // Play sounds
+ * audio.playSound('click', AudioChannel.SFX);
+ * audio.playMusic('background_theme');
+ *
+ * // Volume control
+ * audio.setVolume(AudioChannel.Music, 0.5);
+ * audio.mute(AudioChannel.SFX);
+ *
+ * // Event-based triggers
+ * const unsub = audio.onEvent(eventBus, {
+ *   event: 'player:hit',
+ *   soundId: 'damage',
+ *   options: { volume: 0.8 },
+ * });
+ * ```
+ */
+declare function createAudioManager(adapter?: AudioAdapter): AudioManager;
+
+export { type AudioAdapter, AudioChannel, type AudioChannelValue, type AudioManager, type AudioState, type PlayOptions, type SoundTrigger, createAudioManager };

package/dist/audio/index.js

@@ -0,0 +1 @@
+export{a as AudioChannel,b as createAudioManager}from'../chunk-NZ55KBM6.js';import'../chunk-5PELJRUQ.js';