@plasius/video

Video generation components and helpers for the Plasius ecosystem.

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

Install

npm install @plasius/video

Usage

import {
  AIVideoGenerationScreen,
  createAIVideoGenerationDemoModel,
  aiVideoGenerationTokens,
  aiVideoStageFlow,
  videoPackageInfo,
} from "@plasius/video";

console.log(videoPackageInfo.name, videoPackageInfo.version);
console.log(aiVideoGenerationTokens.color.background);
console.log(aiVideoStageFlow.map((stage) => stage.stage));

const model = createAIVideoGenerationDemoModel("imageSelection");
void AIVideoGenerationScreen;
void model;

Node.js Version

This project uses Node.js 24 by default. The version is pinned in the .nvmrc file.

If you use nvm, run:

nvm use

Package Scope

@plasius/video is intended to host reusable video generation interfaces and shared view-model logic used across Plasius applications.

AI Video Generation Visual Styling Pieces

This package now includes a design-system aligned screen scaffold for:

Prompt entry
Image generation and selection
Video generation and motion editing
Playback controls
Voiceover panel
Export state

Primary exports:

AIVideoGenerationScreen
AIVideoGenerationStudioDemo
createAIVideoGenerationDemoModel
aiVideoGenerationTokens
aiVideoStageFlow
AI_VIDEO_GENERATION_SCREEN_STYLES

Reference design document:

docs/ai-video-generation-screen-visual-styling-guide.md

State Flow Summary

The staged flow aligns to the screen design sequence:

idle
generatingImages
imageSelection
generatingVideo
playback
voiceover
export

Development

npm install
npm run lint
npm run typecheck
npm run build
npm run test:coverage
npm run demo:run

Quality Gates

CI enforces lint, typecheck, runtime dependency audit (npm audit --omit=dev --audit-level=high), build, and test coverage.
Coverage thresholds are enforced in Vitest (lines/functions/statements >= 80, branches >= 70).

Demo Sanity Check

npm run demo:run

Publishing

This package is published via GitHub CD only.

Configure repository environment production with secret NPM_TOKEN.
Run .github/workflows/cd.yml via Actions -> CD (Publish to npm) -> Run workflow.
Select the version bump (patch, minor, major, or none) and optional pre-release id.

Contributing

We welcome contributions. See:

License

Licensed under the Apache-2.0 License.