@vanillaskyai/video 0.8.8 → 0.9.0

package/CHANGELOG.md

@@ -4,6 +4,36 @@ VanillaSky follows semantic versioning. This changelog begins with the 0.1 beta.
 
 ## Unreleased
 
+## 0.9.0
+
+- Continue video playback with subtitles when native browser speech cannot start, without weakening generated-audio readiness or counting paused time toward the fallback.
+
+- Show the spoken opening as a quiet chapter on black when opening media is absent or cannot load. Keep it readable until media or the film is ready, without another generation call.
+
+- Package licensed, self-hosted Roboto fallback fonts for the fixed cinematic typography; remove unused promotional template primitives.
+
+
+### Breaking changes
+
+- Replace the 28 promotional templates with eight cinematic templates: Full-bleed, Chapter, Focus cards, Timeline, Reach out, Comparison, Quote, and Key figure. Graphics use fixed black backgrounds and white/neutral system typography; only Full-bleed and Reach out accept media.
+- Remove configurable `brand` input and persisted `style.brand`, and remove the public `VideoBrand`, `VideoBrandInput`, `VideoBackground`, and `resolveVideoBrand` exports. Persisted schema is now `0.2` and streaming protocol is `0.6`; older payloads are explicitly rejected.
+- Source-owned templates declare authored reveal, hold and exit minimums. Quote and figure examples remain authoring fixtures and never become factual runtime defaults.
+
+Before:
+
+```tsx
+<VideoChat options={{ endpoint: "/api/video-chat", brand: { background: "twilight" } }} />
+```
+
+### Adoption
+
+Remove brand options and regenerate source-owned templates from the new catalog. Re-author or regenerate saved videos from retained source material; do not rename old IDs or change their version field blindly. See [cinematic migration](docs/maintainers/cinematic-migration.md).
+
+```tsx
+<VideoChat options={{ endpoint: "/api/video-chat" }} />
+```
+
+
 ## 0.8.8
 
 - Use equal spacing between Sessions, Settings, and Voice controls on mobile and desktop.

package/PUBLIC-API.md

@@ -131,9 +131,9 @@ playable scenes on an interrupted plan, emitting non-fatal warnings. Explicit
 `invalidPartBehavior: "fail"` retains strict generation semantics.
 
 - A response accepts `prompt`, `mode`, `orientation`, optional bounded
-  `conversation`, `opening`, `brand`, and `style`. `opening` is an optional
+  `conversation`, `opening`, and `style`. `opening` is an optional
   prewritten hook from a selected suggestion. The response returns protocol
-  `0.5` SSE and negotiates `data.video-chat-opening`, which carries the bounded
+  `0.6` SSE and negotiates `data.video-chat-opening`, which carries the bounded
   6-9 word hook and optional stock-search `keyword` and `fallbackKeyword` before the first scene.
 - The planner produces that opening as the first line of the same model stream
   that produces the scenes. The separate opening-media action resolves its
@@ -216,7 +216,7 @@ export function App() {
 ```
 
 Pass the same session configuration through `options`, for example
-`<VideoChat options={{ endpoint, headers, templates, brand }} />`. `className`
+`<VideoChat options={{ endpoint, headers, templates }} />`. `className`
 and `welcomeTitle` are the only shell-level customizations. The stylesheet is
 scoped under `.vanillasky-video-chat` and does not style the host document.
 
@@ -294,10 +294,7 @@ playback is unaffected by either. `onComplete(video)` reports that a streamed
 response finished composing; `onPlaybackEnd(video)` reports that the visible
 playhead actually reached the end for either a stream or saved replay.
 
-`resolveVideoBrand` fills a partial brand with the documented defaults and
-preset backgrounds, producing the fully resolved `VideoBrand` that `parseVideo`
-requires. Use it when authoring a `Video` by hand rather than copying default
-values into application code.
+Graphic scenes use fixed black backgrounds, white/neutral typography, and the system font stack. `VideoInput.brand`, `VideoStyle.brand`, `VideoBrand`, `VideoBrandInput`, `VideoBackground`, and `resolveVideoBrand` are removed. Media retains natural color. Persisted schema `0.2` and event protocol `0.6` reject earlier versions; changing a version field alone is not a migration.
 
 ## Template authoring
 
@@ -394,7 +391,7 @@ from `/server` without crossing a React type boundary.
 
 - A completed `Video` is JSON-serializable and may be stored by the host.
 - Every completed value carries the required storage field
-  `schemaVersion: "0.1"`; it is independent from streaming protocol `0.5`.
+  `schemaVersion: "0.2"`; it is independent from streaming protocol `0.6`.
 - `parseVideo(value: unknown)` is the strict universal storage boundary. It
   validates the full document and returns a detached, deeply frozen `Video`.
 - JSON serialization remains platform-native; the SDK has no redundant public

package/dist/{builtin-server-CUYPIDE7.js → builtin-server-HW6HGXCZ.js}

@@ -1,7 +1,7 @@
 import {
   BUILTIN_SERVER_TEMPLATE_KIT
-} from "./chunk-OWBT45EN.js";
-import "./chunk-4UNKZEAT.js";
+} from "./chunk-MQILEEXC.js";
+import "./chunk-LH4BPALA.js";
 import "./chunk-2E6T633S.js";
 export {
   BUILTIN_SERVER_TEMPLATE_KIT

package/dist/{catalog-types-BIhSpOWK.d.ts → catalog-types-WTbLP6Jh.d.ts}

@@ -36,6 +36,10 @@ type TemplateFamily = "Media & motion" | "Data & metrics" | "Product showcase" |
 interface TemplateTimingMetadata {
     /** Schema fields whose rendered content may inform a future adaptive duration. */
     readonly contentFields: readonly string[];
+    /** Authored motion and uninterrupted reading minimums in seconds. */
+    readonly revealSeconds?: number;
+    readonly holdSeconds?: number;
+    readonly exitSeconds?: number;
     /** How content in contentFields should be measured; no runtime behavior is implied. */
     readonly contentUnit: "words" | "characters" | "items";
 }
@@ -71,4 +75,4 @@ interface SceneTemplateMetadata {
     timing?: TemplateTimingMetadata;
 }
 
-export type { SceneTemplateMetadata as S, TemplateFamily as T, TemplateJob as a, TemplateRegister as b, TemplateTimingMetadata as c, TemplateJsonSchema as d, TemplateTransitionTiming as e, TemplateJsonSchemaProperty as f };
+export type { SceneTemplateMetadata as S, TemplateJsonSchema as T, TemplateFamily as a, TemplateTimingMetadata as b, TemplateTransitionTiming as c, TemplateJsonSchemaProperty as d };

package/dist/chapter-title-YRLIQY3V.js

@@ -0,0 +1,7 @@
+import {
+  TitleSceneTemplate
+} from "./chunk-EWWCQFTI.js";
+import "./chunk-4YM2M62S.js";
+export {
+  TitleSceneTemplate
+};

package/dist/check-runtime.js

@@ -1,14 +1,10 @@
 import {
   VideoFrame
-} from "./chunk-2USVB3CY.js";
-import "./chunk-224QNWRA.js";
-import "./chunk-5CDAM24P.js";
-import "./chunk-XWWLKRNU.js";
+} from "./chunk-3ZTEFJIR.js";
+import "./chunk-UDIODEDK.js";
+import "./chunk-TVIU23OM.js";
 import "./chunk-SPVTJH3F.js";
-import {
-  resolveVideoBrand
-} from "./chunk-XGRA2MUV.js";
-import "./chunk-WJ6FLKNC.js";
+import "./chunk-R3XAOMKP.js";
 import "./chunk-73NTSFFI.js";
 
 // src/cli/check-runtime.ts
@@ -48,7 +44,7 @@ async function renderTemplateChecks(input) {
   for (const orientation of ["portrait", "landscape"]) {
     const [width, height] = orientation === "portrait" ? [1080, 1920] : [1920, 1080];
     const config = {
-      schemaVersion: "0.1",
+      schemaVersion: "0.2",
       orientation,
       scenes: [{
         id: "authoring-check",
@@ -56,12 +52,7 @@ async function renderTemplateChecks(input) {
         variables: input.variables,
         timing: { startTime: 0, endTime: input.duration, fixedDuration: input.duration }
       }],
-      style: {
-        brand: resolveVideoBrand({
-          font: "Inter, sans-serif",
-          colors: { primary: "#6D5EF5", secondary: "#17122F", foreground: "#FFFFFF" }
-        })
-      }
+      style: {}
     };
     for (const progress of progressPoints) {
       let first;