@pneuma-craft/video 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to `@pneuma-craft/video` will be documented in this file.
+
+## 0.4.0
+
+### Fixed
+
+- **Video clips with embedded audio now play and export with sound.** Previously the audio scheduler, audio preload, and offline audio renderer all hard-filtered to `track.type === 'audio'`, so any video clip dropped on a `video` track was silent in both preview and export — only clips on dedicated audio tracks produced sound. All three paths now include `video` tracks and attempt `decodeAudio` on every clip; clips whose asset has no audio stream (images, silent videos) are silently skipped. Mute gate is `track.muted` for both track types, matching standard NLE semantics.
+
+### Peer dependency
+
+- Requires `@pneuma-craft/timeline >= 0.3.0` for the split `muted` (audio) / `visible` (picture) semantics. Pinning an older timeline still works but muting a video track will also hide its picture.
+
+## 0.3.0
+
+### Added
+
+- `SubtitleRenderer` injection point shared by preview (`createPlaybackEngine`) and export (`createExportEngine`). See commit `3b014c5` for details.
+
+## 0.2.0
+
+### Fixed
+
+- Preserve alpha channel end-to-end for transparent layers (Canvas2D + WebGPU compositors, image letterbox, mediabunny CanvasSink `alpha: true`).
+
+## 0.1.0
+
+- Initial release.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pandazki
+
+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,28 @@
+# @pneuma-craft/video
+
+Video engine for pneuma-craft — decode, composite, preview, and export. Built on [MediaBunny](https://mediabunny.dev) (WebCodecs) for I/O, with self-built Canvas 2D compositor and Web Audio scheduler for playback.
+
+```bash
+bun add @pneuma-craft/video
+```
+
+## What's in here
+
+- **Decoder** — MediaBunny `Input` + `CanvasSink` / `AudioBufferSink`
+- **Compositor** — Canvas 2D layer compositor with transforms, opacity, blend modes
+- **Audio scheduler** — Web Audio graph with `AudioContext.currentTime` as master clock; drift-corrected against video
+- **Preview engine** — drives a rAF loop to play a `@pneuma-craft/timeline` composition
+- **Exporter** — renders frame-by-frame via WebCodecs `VideoEncoder`, mixes audio via `OfflineAudioContext`, muxes via MediaBunny `Output`
+- **Pluggable subtitle renderer** — shared between preview and export
+
+## Browser support
+
+Requires WebCodecs (`VideoDecoder`/`VideoEncoder`) and modern Canvas 2D. Tested on Chromium-based browsers and Safari Tech Preview.
+
+## Documentation
+
+See the [pneuma-craft repository](https://github.com/pandazki/pneuma-craft) for the full design spec, architecture, and usage examples.
+
+## License
+
+MIT © Pandazki