greenlight-motion 0.2.1 → 0.2.3

package/README.md

@@ -17,16 +17,16 @@ The agent writes the video as data: a `project.json` and its files. The engine t
 ## Quick start
 
 ```bash
-npx greenlight-motion@0.2.1 doctor          # Node 18+, Chrome or Edge, WebGPU, H.264: what's missing and how to fix it
-npx greenlight-motion@0.2.1 init my-video   # a working starter: index.html, project.json, assets/
+npx greenlight-motion@0.2.3 doctor          # Node 18+, Chrome or Edge, WebGPU, H.264: what's missing and how to fix it
+npx greenlight-motion@0.2.3 init my-video   # a working starter: index.html, project.json, assets/
 # edit my-video/project.json, put pictures / video / sound in my-video/assets/
 # or: write my-video/script.json (a scene script, skill/references/scene-script.md), then
-npx greenlight-motion@0.2.1 script my-video # script.json → project.json with the Video Editor's own presets
-npx greenlight-motion@0.2.1 check my-video  # what to fix: missing files, template mistakes, blank frames, broken plugins
-npx greenlight-motion@0.2.1 stills my-video # frames + a labelled contact sheet, to look at
-npx greenlight-motion@0.2.1 render my-video --fps 60 --motion-blur
-npx greenlight-motion@0.2.1 pack my-video   # everything in ONE html file
-npx greenlight-motion@0.2.1 pack my-video --glvideo   # ONE .glvideo: double-clicked, it opens in GreenLight Dash
+npx greenlight-motion@0.2.3 script my-video # script.json → project.json with the Video Editor's own presets
+npx greenlight-motion@0.2.3 check my-video  # what to fix: missing files, template mistakes, blank frames, broken plugins
+npx greenlight-motion@0.2.3 stills my-video # frames + a labelled contact sheet, to look at
+npx greenlight-motion@0.2.3 render my-video --fps 60 --motion-blur
+npx greenlight-motion@0.2.3 pack my-video   # everything in ONE html file
+npx greenlight-motion@0.2.3 pack my-video --glvideo   # ONE .glvideo: double-clicked, it opens in GreenLight Dash
 ```
 
 Also: `trace` (every animated layer's values frame by frame, plus the layer's moments), `set key=value`
@@ -72,7 +72,7 @@ The engine is one classic script, so it runs from a double-clicked file, a CDN o
 
 ```html
 <div id="app"></div>
-<script src="https://cdn.jsdelivr.net/npm/greenlight-motion@0.2.1/dist/greenlight-motion.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/greenlight-motion@0.2.3/dist/greenlight-motion.js"></script>
 <script>
   GreenLightMotion.mountStudio(document.getElementById('app'), {
     project: { /* project.json */ },

package/cli/index.mjs

@@ -314,6 +314,12 @@ async function check() {
     for (const p of await page.evaluate(async (proj) => window.GreenLightMotion.checkSoundCues(await window.GreenLightMotion.normalize(proj)), project)) {
       problems.push({ code: 'sound', detail: p, fix: 'fix project.sounds (npx greenlight-motion schema sounds lists the library)' });
     }
+    // a track matte's source is hidden only while a layer that uses it is on screen; outside that it draws as itself
+    for (const g of await page.evaluate((proj) => window.GreenLightMotion.matteGaps(proj), project)) {
+      problems.push({ code: 'matte-source', ref: g.source,
+        detail: `"${g.source}" shows on screen from ${g.from} s to ${g.to} s, when no layer that uses it as a track matte (${g.consumers.join(', ')}) is on screen`,
+        fix: `start and end "${g.source}" with the layer it cuts: the engine hides a matte source only while a layer that uses it is on screen` });
+    }
     if (!(duration > 0)) problems.push({ code: 'empty', detail: 'the project has no length', fix: 'add layers to channels[].items with clips that have a duration' });
     const blank = [];
     for (const t of parseTimes(duration).slice(0, 4)) {
@@ -571,6 +577,8 @@ function schema() {
   switch (topic) {
     case 'format': {
       const refs = path.join(PKG, 'skill', 'references');
+      const essentials = readFileSync(path.join(PKG, 'skill', 'SKILL.md'), 'utf8').split('## The project format — essentials')[1]?.split('\n## ')[0];
+      if (essentials) show(`# The project format — essentials${essentials.trimEnd()}\n`);
       show(`The project format is the GreenLight Dash Video Editor's. Read:
   ${path.join(PKG, 'skill', 'SKILL.md')}            how to work, and the essentials
   ${refs}/            one file per topic: ${existsSync(refs) ? readdirSync(refs).map((f) => f.replace('.md', '')).join(', ') : '(missing)'}