@vanillaskyai/video 0.1.0 → 0.1.1-beta.1

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 VanillaSky follows semantic versioning. This changelog begins with the 0.1 beta.
 
+## Unreleased
+
+<!-- Add release notes here before running release:prepare. -->
+
+## 0.1.1-beta.1
+
+### Patch Changes
+
+- 9c42eb7: Publish the customer-compatible beta through the read-only npm API comparison.
+
+## 0.1.1-beta.0
+
+### Patch Changes
+
+- 66e8e95: Enforce pre-1.0 compatibility intent with structurally parsed release evidence.
+
 ## 0.1.0
 
 Initial beta release for `@vanillaskyai/video`.

package/PUBLIC-API.md

@@ -1,6 +1,6 @@
 # VanillaSky Video 0.1 public API
 
-Status: frozen public beta contract for `0.1.0`.
+Status: frozen public beta contract for `0.1.1-beta.1`.
 
 This document defines the API that may enter the fresh
 `@vanillaskyai/video` package. An export not listed here is internal. Tests and
@@ -18,8 +18,18 @@ public API review.
 
 - `0.1.x` patch releases do not make breaking changes to documented APIs or the
   serialized `Video` schema.
-- A later `0.x` minor may make a breaking change only with release notes and a
-  concrete adoption example.
+- A compatible later `0.x` minor needs no migration ceremony. A breaking
+  pre-1.0 minor requires either its package-targeting `minor` Changeset (on a
+  feature PR) or its generated candidate changelog section (on the Version
+  Packages PR) to contain both `### Breaking changes` and `### Adoption`.
+  Those sections must include concrete fenced before and after code examples,
+  respectively. Start a breaking Changeset with its one-line summary, followed
+  by those headings, so Changesets preserves both as real headings in the
+  generated changelog. The verifier accepts the configured Changesets
+  changelog's canonical two-space continuation indentation, but not headings
+  hidden inside code fences. On a feature PR, only a Changeset added since the
+  pull request's exact base commit can provide this evidence. A `patch`
+  Changeset never authorizes a breaking change.
 - An API prefixed with `experimental_` may change in a patch. Canonical examples
   must pin an exact package version when they use one.
 - Deprecated APIs remain usable until the next minor release. The `0.1`
@@ -30,6 +40,16 @@ public API review.
 - Framework adapters are examples, not separate public APIs. The release suite
   verifies current Next.js and Vite production builds.
 
+The automated npm comparison runs for every candidate, including a feature PR
+whose package version still equals npm `latest` and a Version Packages PR whose
+Changesets have already been consumed. It is intentionally conservative: every
+existing normalized declaration and reachable support declaration must remain
+exactly equal because the report cannot safely distinguish input and output positions.
+As a result, even optional field additions to an existing public
+type fail a patch gate; use a documented pre-1.0 minor unless a separately
+reviewed, direction-aware compatibility check can prove the change safe. New
+exports, wider supported peer ranges, and new optional peers remain additive.
+
 ## Environment boundaries
 
 | Entry point | Environment | May import React | May import Node built-ins |

package/README.md

@@ -1,6 +1,6 @@
 # Give your AI a video output
 
-![Version 0.1.0 beta](https://img.shields.io/badge/version-0.1.0_beta-7c3aed)
+![Version 0.1.1-beta.1 beta](https://img.shields.io/badge/version-0.1.1-beta.1_beta-7c3aed)
 
 **VanillaSky is the open-source video response layer.** Turn text, structured
 data, and live application context into personalized video responses that start
@@ -17,7 +17,7 @@ the planning prompt, trusted templates, validation, streaming, and player.
 For humans:
 
 ```bash
-npm install @vanillaskyai/video@0.1.0 ai @ai-sdk/openai
+npm install @vanillaskyai/video@0.1.1-beta.1 ai @ai-sdk/openai
 ```
 
 For coding agents:
@@ -101,7 +101,7 @@ shows each complete, validated scene as soon as it is ready and returns a
 deterministic `Video` object when generation finishes.
 
 A copy-and-run app is in
-[`examples/nextjs-quickstart`](https://github.com/VanillaSkyAi/video/tree/v0.1.0/examples/nextjs-quickstart).
+[`examples/nextjs-quickstart`](https://github.com/VanillaSkyAi/video/tree/v0.1.1-beta.1/examples/nextjs-quickstart).
 
 ## Shape the response
 

package/docs/getting-started.md

@@ -5,7 +5,7 @@
 Install VanillaSky:
 
 ```bash
-npm install @vanillaskyai/video@0.1.0 ai @ai-sdk/openai
+npm install @vanillaskyai/video@0.1.1-beta.1 ai @ai-sdk/openai
 ```
 
 Set your provider key in `.env.local` (never commit it):
@@ -49,7 +49,7 @@ The local bypass is intentionally fail-closed: it accepts only localhost while
 Next.js is in development and denies every production request. Replace it with
 your real session validation before deploying. For literal files and commands,
 use the tested
-[`examples/nextjs-quickstart` directory](https://github.com/VanillaSkyAi/video/tree/v0.1.0/examples/nextjs-quickstart).
+[`examples/nextjs-quickstart` directory](https://github.com/VanillaSkyAi/video/tree/v0.1.1-beta.1/examples/nextjs-quickstart).
 
 `model` can come from any AI SDK provider, registry, gateway, compatible API,
 or custom implementation. The application can choose a cheaper or faster model

package/docs/integrate-nextjs.md

@@ -5,7 +5,7 @@
 Install VanillaSky and one AI SDK provider:
 
 ```bash
-npm install @vanillaskyai/video@0.1.0 ai @ai-sdk/openai
+npm install @vanillaskyai/video@0.1.1-beta.1 ai @ai-sdk/openai
 ```
 
 Create an ignored `.env.local`:
@@ -71,7 +71,7 @@ requests; replace it with your application's session validation before
 deploying.
 
 The copy-and-run app is in the
-[`examples/nextjs-quickstart` directory](https://github.com/VanillaSkyAi/video/tree/v0.1.0/examples/nextjs-quickstart).
+[`examples/nextjs-quickstart` directory](https://github.com/VanillaSkyAi/video/tree/v0.1.1-beta.1/examples/nextjs-quickstart).
 
 For another LLM, replace `openai(...)` with the matching AI SDK model. The route
 shape and React code stay the same. See [Provider integration](provider-integration.md)

package/examples/nextjs-quickstart/package.json

@@ -9,7 +9,7 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "^4.0.42",
-    "@vanillaskyai/video": "0.1.0",
+    "@vanillaskyai/video": "0.1.1-beta.1",
     "ai": "^7.0.66",
     "next": "16.3.1",
     "react": "19.2.8",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanillaskyai/video",
-  "version": "0.1.0",
+  "version": "0.1.1-beta.1",
   "description": "Open-source video response SDK for personalized AI applications.",
   "keywords": [
     "generative-video",
@@ -99,6 +99,11 @@
     "lint": "eslint .",
     "catalog:sync": "tsx scripts/generate-builtin-catalog.ts",
     "catalog:check": "tsx scripts/generate-builtin-catalog.ts --check",
+    "changeset": "changeset",
+    "changeset:status": "changeset status",
+    "changeset:check": "node scripts/verify-changeset.mjs",
+    "version-packages:prepare": "node scripts/version-packages.mjs",
+    "verify:version-packages-pr": "node scripts/verify-version-packages-pr.mjs",
     "registry:sync": "npm run catalog:sync && node scripts/sync-template-registry.mjs",
     "registry:check": "node scripts/sync-template-registry.mjs --check && npm run catalog:check",
     "template:check": "tsx scripts/template-check.ts",
@@ -112,6 +117,7 @@
     "verify:package-size": "tsx scripts/verify-package-size.ts",
     "verify:api": "npm run build && node scripts/verify-public-api-surface.mjs",
     "verify:package": "npm run build && node scripts/verify-packed-package.mjs",
+    "release:prepare": "node scripts/release-prepare.mjs",
     "release:dry-run": "node scripts/release-dry-run.mjs",
     "release:preflight": "node scripts/release-preflight.mjs",
     "release:check": "npm run verify:api && npm run release:dry-run"
@@ -134,23 +140,26 @@
   },
   "devDependencies": {
     "@anthropic-ai/sdk": "^0.116.0",
+    "@changesets/cli": "3.0.1",
+    "@changesets/parse": "1.0.0",
     "@eslint/js": "^9.39.1",
     "@playwright/test": "1.62.0",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^24.10.1",
     "@types/react": "^18.3.28",
     "@types/react-dom": "^18.3.7",
-    "eslint": "^9.39.1",
     "es-module-lexer": "^1.7.0",
+    "eslint": "^9.39.1",
     "globals": "^16.5.0",
     "jsdom": "^26.1.0",
+    "mdast-util-from-markdown": "2.0.3",
     "openai": "^7.4.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "tsup": "^8.5.1",
+    "tsx": "^4.23.12",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.48.1",
-    "tsx": "^4.23.12",
     "vitest": "^3.2.4"
   },
   "overrides": {