@plasius/video 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -9,7 +9,10 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 ## [Unreleased]
 
 - **Added**
-  - (placeholder)
+  - Added AI video generation design-system modules under `src/ai-video-generation/` with typed stage, token, and model definitions.
+  - Added `AIVideoGenerationScreen` and `AIVideoGenerationStudioDemo` React components to provide a demo-ready staged UI scaffold.
+  - Added visual-style token exports (`aiVideoGenerationTokens`) and stage-flow metadata (`aiVideoStageFlow`) for host app integration.
+  - Added tests for design token values, stage ordering, and core style hooks in `tests/ai-video-generation-design.test.ts`.
 
 - **Changed**
   - Added package-level GitHub CD publish workflow at `.github/workflows/cd.yml` for npm publication with provenance.
@@ -19,9 +22,12 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
   - Updated Vitest coverage reporters to include `lcov` output for Codecov ingestion.
   - Made SBOM generation non-blocking in CD and only attest when `sbom.cdx.json` is present.
   - Made SBOM release-asset upload non-blocking to avoid failing publish after successful npm release.
+  - Updated README badges to include Codecov coverage and point workflow status to `cd.yml`.
+  - Normalized README section headings/formatting for consistent markdown rendering.
+  - Expanded README/demo examples to include the AI video generation screen scaffold and exported style primitives.
 
 - **Fixed**
-  - (placeholder)
+  - Updated `videoPackageInfo.version` to match the current package line.
 
 - **Security**
   - Removed `depcheck` (and its `multimatch`/`minimatch` chain) from devDependencies to resolve reported high-severity audit findings.

package/README.md

@@ -1,8 +1,9 @@
 # @plasius/video
 
 [![npm version](https://img.shields.io/npm/v/@plasius/video.svg)](https://www.npmjs.com/package/@plasius/video)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/Plasius-LTD/video/ci.yml?branch=main&label=build&style=flat)](https://github.com/Plasius-LTD/video/actions/workflows/ci.yml)
-[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
+[![CD Status](https://img.shields.io/github/actions/workflow/status/Plasius-LTD/video/cd.yml?branch=main&label=cd&style=flat)](https://github.com/Plasius-LTD/video/actions/workflows/cd.yml)
+[![coverage](https://img.shields.io/codecov/c/github/Plasius-LTD/video)](https://codecov.io/gh/Plasius-LTD/video)
+[![License](https://img.shields.io/github/license/Plasius-LTD/video)](./LICENSE)
 [![Code of Conduct](https://img.shields.io/badge/code%20of%20conduct-yes-blue.svg)](./CODE_OF_CONDUCT.md)
 [![Security Policy](https://img.shields.io/badge/security%20policy-yes-orange.svg)](./SECURITY.md)
 [![Changelog](https://img.shields.io/badge/changelog-md-blue.svg)](./CHANGELOG.md)
@@ -11,25 +12,31 @@ Video generation components and helpers for the Plasius ecosystem.
 
 Apache-2.0. ESM + CJS builds. TypeScript types included.
 
----
-
-## Installation
+## Install
 
 ```bash
 npm install @plasius/video
 ```
 
----
-
 ## Usage
 
 ```ts
-import { videoPackageInfo } from "@plasius/video";
+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
 
@@ -41,13 +48,45 @@ If you use [nvm](https://github.com/nvm-sh/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`](./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
 
@@ -58,7 +97,11 @@ npm run test
 npm run demo:run
 ```
 
----
+## Demo Sanity Check
+
+```bash
+npm run demo:run
+```
 
 ## Publishing
 
@@ -68,8 +111,6 @@ This package is published via GitHub CD only.
 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:
@@ -78,8 +119,6 @@ We welcome contributions. See:
 - [Code of Conduct](./CODE_OF_CONDUCT.md)
 - [Contributor License Agreement](./legal/CLA.md)
 
----
-
 ## License
 
 Licensed under the [Apache-2.0 License](./LICENSE).