@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:

1. idle
2. generatingImages
3. imageSelection
4. generatingVideo
5. playback
6. voiceover
7. 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.

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

Contributing

We welcome contributions. See:

• Contributing Guide
• Code of Conduct
• Contributor License Agreement

License

Licensed under the Apache-2.0 License.