stillmade-sdk 0.1.8 → 0.1.10

package/blocks/native/sm.export-video/versions/2.1.0/package.js

@@ -0,0 +1,580 @@
+// Generated by scripts/build-owned-blocks.mjs. Edit the owned source files.
+export default {
+  "manifest": {
+    "schemaVersion": 1,
+    "sdkVersion": "0.1.0",
+    "id": "sm.export-video",
+    "version": "2.1.0",
+    "name": "Export video",
+    "description": "Render a timeline to a downloadable video file, or make one from the project's shot plan with photos, clips and narration from earlier Steps, then explicitly save it as a connected media asset.",
+    "kind": "task",
+    "runtime": "javascript",
+    "entry": "src/run.js",
+    "license": "MIT",
+    "provenance": {
+      "notice": "Original source (authorship declared by the packager)\nLicense: MIT\nChanges: Original implementation declared by the packager; no reused repository or dependency code.\nFiles: LICENSE, src/run.js\n\nMIT License\n\nCopyright (c) 2026 StillMade contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n",
+      "portableSources": [
+        {
+          "kind": "original",
+          "license": "MIT",
+          "paths": [
+            "LICENSE",
+            "src/run.js"
+          ],
+          "evidence": [
+            "upstream/0/LICENSE",
+            "upstream/0/src/run.js"
+          ],
+          "changes": "Original implementation declared by the packager; no reused repository or dependency code."
+        }
+      ]
+    },
+    "inputs": {
+      "input": {
+        "type": "timeline",
+        "primary": true,
+        "semantic": "timeline",
+        "required": false,
+        "description": "An explicitly connected timeline to render as it is.",
+        "sources": [
+          "user",
+          "upstream"
+        ]
+      },
+      "media": {
+        "type": "asset[]",
+        "semantic": "project_media",
+        "accepts": [
+          "legacy.asset-list.assets"
+        ],
+        "required": false,
+        "description": "Photos and clips from an earlier Step, such as Import media. With no timeline they are placed on the project's shots in order, or shown one after another.",
+        "sources": [
+          "upstream",
+          "adapter"
+        ]
+      },
+      "narration": {
+        "type": "audio",
+        "semantic": "narration_audio",
+        "required": false,
+        "description": "Narration from an earlier Step, such as Voiceover. With no timeline it plays under the video, and the shots are fitted to its length.",
+        "sources": [
+          "upstream",
+          "adapter"
+        ]
+      },
+      "renderAspect": {
+        "type": "text",
+        "semantic": "render_aspect",
+        "required": false,
+        "default": "16:9",
+        "description": "Frame shape of a video made from shots and media. A connected or project timeline keeps its own.",
+        "sources": [
+          "user",
+          "default"
+        ]
+      },
+      "renderFps": {
+        "type": "text",
+        "semantic": "render_fps",
+        "required": false,
+        "default": "30",
+        "description": "Render frames per second.",
+        "sources": [
+          "user",
+          "default"
+        ]
+      },
+      "renderResolution": {
+        "type": "text",
+        "semantic": "render_resolution",
+        "required": false,
+        "default": "1080",
+        "description": "Output height in pixels.",
+        "sources": [
+          "user",
+          "default"
+        ]
+      },
+      "renderQuality": {
+        "type": "text",
+        "semantic": "render_quality",
+        "required": false,
+        "default": "high",
+        "description": "Output quality.",
+        "sources": [
+          "user",
+          "default"
+        ]
+      },
+      "projectTimeline": {
+        "type": "timeline",
+        "context": "timeline",
+        "semantic": "timeline",
+        "required": false,
+        "description": "Current project timeline when no Block is connected.",
+        "sources": [
+          "project"
+        ]
+      },
+      "projectShotPlan": {
+        "type": "shot-plan",
+        "context": "shotPlan",
+        "semantic": "production_shot_plan",
+        "required": false,
+        "description": "The project's shot plan. Its order and timings decide when each photo or clip shows.",
+        "sources": [
+          "project"
+        ]
+      }
+    },
+    "outputs": {
+      "mediaAction": {
+        "type": "approval",
+        "role": "portable_media_action",
+        "semantic": "portable_media_action",
+        "description": "A bounded render request for explicit review."
+      },
+      "output": {
+        "type": "video",
+        "semantic": "rendered_video",
+        "required": false,
+        "description": "The selected durable video asset from the completed render."
+      }
+    },
+    "permissions": {
+      "project": [
+        "context.timeline.read",
+        "context.shotPlan.read"
+      ],
+      "network": [],
+      "filesystem": [],
+      "secrets": [],
+      "actions": [
+        "final.render"
+      ]
+    },
+    "ui": [
+      {
+        "control": "select",
+        "port": "renderAspect",
+        "options": [
+          "16:9",
+          "9:16",
+          "1:1"
+        ]
+      },
+      {
+        "control": "select",
+        "port": "renderFps",
+        "options": [
+          "24",
+          "30",
+          "60"
+        ]
+      },
+      {
+        "control": "select",
+        "port": "renderResolution",
+        "options": [
+          "720",
+          "1080",
+          "2160"
+        ]
+      },
+      {
+        "control": "select",
+        "port": "renderQuality",
+        "options": [
+          "low",
+          "medium",
+          "high"
+        ]
+      }
+    ],
+    "platforms": {
+      "phone": {
+        "supported": true
+      },
+      "browser": {
+        "supported": true
+      },
+      "desktop": {
+        "supported": true
+      }
+    }
+  },
+  "code": "// A connected timeline, else the project's timeline, is rendered as it is. With\n// neither, the video is made here from the project's shot plan, the connected\n// photos and clips, and the connected narration: the shots keep their order and\n// timings, each shows the next photo or clip, and the shots are fitted to the\n// narration's length. Media values are used exactly as the earlier Step stored them.\nconst list=value=>Array.isArray(value)?value:[];\nconst number=value=>typeof value==='number'?value:typeof value==='string'&&value.trim()?Number(value):NaN;\nconst positive=value=>{const n=number(value);return Number.isFinite(n)&&n>0?n:0;};\nconst round=value=>Math.round(value*1000)/1000;\nconst copy=value=>JSON.parse(JSON.stringify(value));\nconst pick=(value,keys)=>{const out={};for(const key of keys)if(value[key]!==undefined&&value[key]!==null)out[key]=copy(value[key]);return out;};\nconst playable=timeline=>!!timeline&&typeof timeline==='object'&&!Array.isArray(timeline)&&(list(timeline.clips).length>0||list(timeline.audioItems).length>0);\nconst settings={fps:Number(input.renderFps||30),resolution:Number(input.renderResolution||1080),quality:String(input.renderQuality||'high')};\nconst aspect=String(input.renderAspect||'16:9');\nif(![24,30,60].includes(settings.fps)||![720,1080,2160].includes(settings.resolution)||!['low','medium','high'].includes(settings.quality)||!['16:9','9:16','1:1'].includes(aspect))throw new Error('Choose approved export settings.');\nconst MEDIA_FIELDS=['kind','assetId','versionId','url','source','localKey','original','mimeType','width','height'];\n// A slow push in or out keeps a still photo alive on screen.\nconst motion=index=>({type:'zoom',zoomAmount:1.08,zoomDirection:index%2?'out':'in',intensity:100,easing:'ease-in-out'});\n\nfunction assemble(){\n const visuals=list(input.media).filter(item=>item&&typeof item==='object'&&(item.kind==='image'||item.kind==='video')&&typeof item.url==='string'&&item.url).slice(0,500);\n const shots=list(input.projectShotPlan&&input.projectShotPlan.shots).filter(shot=>shot&&typeof shot==='object'&&!Array.isArray(shot));\n if(!visuals.length)throw new Error(shots.length?`This project has ${shots.length} shot${shots.length===1?'':'s'} but no photos or clips to show. Connect them from an earlier Step, such as Import media, and run that Step.`:'There is nothing to show yet. Connect photos or clips from an earlier Step, such as Import media, or connect a timeline.');\n const voice=input.narration&&typeof input.narration==='object'&&input.narration.kind==='audio'&&typeof input.narration.url==='string'&&input.narration.url?input.narration:null;\n const spoken=voice?positive(voice.duration):0;\n const timing=shot=>{const start=number(shot.startTime),end=number(shot.endTime);return Number.isFinite(start)&&Number.isFinite(end)&&start>=0&&end>start?{start,end}:null;};\n const timed=shots.map(timing);\n const lengths=(items,length)=>{let cursor=0;return items.map((item,index)=>{const unit={shot:item.shot,start:cursor,end:cursor+length(item,index)};cursor=unit.end;return unit;});};\n let units;\n // Each timed shot lasts until the next one starts, so a pause stays with the shot before it.\n if(shots.length&&timed.every((t,index)=>t&&(!index||t.start>=timed[index-1].start)))units=shots.map((shot,index)=>({shot,start:index?timed[index].start:0,end:index<shots.length-1?timed[index+1].start:timed[index].end}));\n else if(shots.length)units=lengths(shots.map(shot=>({shot})),({shot},index)=>timed[index]?timed[index].end-timed[index].start:positive(shot.estimatedScreenTime)||positive(shot.durationMs)/1000||3);\n else units=[];\n units=units.filter(unit=>unit.end-unit.start>0.01);\n // No shot plan: each photo shows for 3 seconds and each clip for its own length (at most a minute).\n if(!units.length)units=lengths(visuals.map(()=>({shot:null})),(_,index)=>visuals[index].kind==='video'&&positive(visuals[index].duration)?Math.min(positive(visuals[index].duration),60):3);\n const planned=units[units.length-1].end,scale=spoken>0?spoken/planned:1;\n if(planned*scale>21600)throw new Error('This video would be longer than 6 hours. Shorten the shot plan or the narration.');\n const clips=[],count=units.length,media=visuals.length;\n const place=(item,from,to,shot)=>{\n  const index=clips.length,start=round(from*scale),end=round(to*scale);\n  clips.push({...pick(item,MEDIA_FIELDS),id:`clip-${index+1}`,title:String(item.name||item.label||item.title||`${item.kind==='video'?'Clip':'Photo'} ${index+1}`).slice(0,200),trackId:'video',start,duration:round(end-start),trimStart:0,speed:1,...(item.kind==='image'?{motion:motion(index)}:{}),...(shot&&typeof shot.id==='string'?{shotId:shot.id}:{})});\n };\n // More photos than shots: a shot shows its photos in turn. Fewer: a photo spans neighbouring shots.\n if(media>=count)for(let shot=0;shot<count;shot++){\n  const first=Math.floor(shot*media/count),last=Math.floor((shot+1)*media/count),unit=units[shot],step=(unit.end-unit.start)/(last-first);\n  for(let item=first;item<last;item++)place(visuals[item],unit.start+(item-first)*step,item===last-1?unit.end:unit.start+(item-first+1)*step,unit.shot);\n }\n else for(let item=0;item<media;item++){\n  const first=Math.floor(item*count/media),last=Math.floor((item+1)*count/media);\n  place(visuals[item],units[first].start,units[last-1].end,units[first].shot);\n }\n const shown=clips.reduce((max,clip)=>Math.max(max,clip.start+clip.duration),0),targetDuration=round(Math.max(shown,spoken));\n const audioItems=voice?[{...pick(voice,['kind','assetId','versionId','url','source','localKey','original','mimeType']),id:'narration',title:'Narration',trackId:'narration',start:0,duration:spoken?round(spoken):targetDuration,trimStart:0,volume:100}]:[];\n return {schemaVersion:1,aspect,clips,audioItems,captions:[],textOverlays:[],effects:[],targetDuration,trackOrder:['video']};\n}\n\nconst chosen=playable(input.input)?input.input:playable(input.projectTimeline)?input.projectTimeline:null;\nconst timeline=chosen?copy(chosen):assemble();\nconst clips=list(timeline.clips);\nconst audio=list(timeline.audioItems);\nconst overlays=[...list(timeline.captions),...list(timeline.textOverlays),...list(timeline.effects)];\nconst end=item=>Number(item.start||0)+Number(item.duration||0);\nconst targetDuration=Math.max(0,Number(timeline.targetDuration)||0,...clips.map(end),...audio.map(end),...overlays.map(end));\nif(!Number.isFinite(targetDuration)||targetDuration<=0||targetDuration>21600)throw new Error('The export duration must be between 0 and 21600 seconds.');\nreturn {mediaAction:{schemaVersion:1,kind:'stillmade.media-action',operation:'final.render',request:{schemaVersion:1,kind:'video',timeline:{...timeline,clips,audio,overlays,targetDuration},settings,source:{id:'sm.export-video',version:'2.1.0'}},resultPort:'output'}};\n",
+  "tests": [
+    {
+      "name": "Prepares an exact render request for a connected timeline without rendering or uploading",
+      "input": {
+        "input": {
+          "schemaVersion": 1,
+          "activeTimelineId": "timeline-1",
+          "clips": [
+            {
+              "id": "clip-1",
+              "trackId": "video",
+              "start": 0,
+              "duration": 2,
+              "url": "/api/media/owner/sample.mp4"
+            }
+          ],
+          "audioItems": [],
+          "captions": [],
+          "textOverlays": [],
+          "effects": []
+        }
+      },
+      "expected": {
+        "mediaAction": {
+          "schemaVersion": 1,
+          "kind": "stillmade.media-action",
+          "operation": "final.render",
+          "request": {
+            "schemaVersion": 1,
+            "kind": "video",
+            "timeline": {
+              "schemaVersion": 1,
+              "activeTimelineId": "timeline-1",
+              "clips": [
+                {
+                  "id": "clip-1",
+                  "trackId": "video",
+                  "start": 0,
+                  "duration": 2,
+                  "url": "/api/media/owner/sample.mp4"
+                }
+              ],
+              "audioItems": [],
+              "captions": [],
+              "textOverlays": [],
+              "effects": [],
+              "audio": [],
+              "overlays": [],
+              "targetDuration": 2
+            },
+            "settings": {
+              "fps": 30,
+              "resolution": 1080,
+              "quality": "high"
+            },
+            "source": {
+              "id": "sm.export-video",
+              "version": "2.1.0"
+            }
+          },
+          "resultPort": "output"
+        }
+      }
+    },
+    {
+      "name": "Makes the video from the project shot plan, connected photos and narration",
+      "input": {
+        "media": [
+          {
+            "kind": "image",
+            "assetId": "photo-1",
+            "versionId": "photo-1-v1",
+            "url": "/api/media/owner/front.jpg",
+            "name": "front.jpg"
+          },
+          {
+            "kind": "image",
+            "assetId": "photo-2",
+            "versionId": "photo-2-v1",
+            "url": "/api/media/owner/side.jpg",
+            "name": "side.jpg"
+          },
+          {
+            "kind": "image",
+            "assetId": "photo-3",
+            "versionId": "photo-3-v1",
+            "url": "/api/media/owner/interior.jpg",
+            "name": "interior.jpg"
+          }
+        ],
+        "narration": {
+          "kind": "audio",
+          "assetId": "voiceover-1",
+          "versionId": "voiceover-1-v1",
+          "url": "/api/media/owner/voiceover.mp3",
+          "duration": 9
+        },
+        "projectShotPlan": {
+          "schemaVersion": 1,
+          "shots": [
+            {
+              "id": "shot-1",
+              "startTime": 0,
+              "endTime": 4,
+              "voiceoverText": "Meet the 2021 Honda CR-V EX."
+            },
+            {
+              "id": "shot-2",
+              "startTime": 4,
+              "endTime": 8,
+              "voiceoverText": "Honda Sensing comes standard."
+            }
+          ]
+        }
+      },
+      "expected": {
+        "mediaAction": {
+          "schemaVersion": 1,
+          "kind": "stillmade.media-action",
+          "operation": "final.render",
+          "request": {
+            "schemaVersion": 1,
+            "kind": "video",
+            "timeline": {
+              "schemaVersion": 1,
+              "aspect": "16:9",
+              "clips": [
+                {
+                  "kind": "image",
+                  "assetId": "photo-1",
+                  "versionId": "photo-1-v1",
+                  "url": "/api/media/owner/front.jpg",
+                  "id": "clip-1",
+                  "title": "front.jpg",
+                  "trackId": "video",
+                  "start": 0,
+                  "duration": 4.5,
+                  "trimStart": 0,
+                  "speed": 1,
+                  "motion": {
+                    "type": "zoom",
+                    "zoomAmount": 1.08,
+                    "zoomDirection": "in",
+                    "intensity": 100,
+                    "easing": "ease-in-out"
+                  },
+                  "shotId": "shot-1"
+                },
+                {
+                  "kind": "image",
+                  "assetId": "photo-2",
+                  "versionId": "photo-2-v1",
+                  "url": "/api/media/owner/side.jpg",
+                  "id": "clip-2",
+                  "title": "side.jpg",
+                  "trackId": "video",
+                  "start": 4.5,
+                  "duration": 2.25,
+                  "trimStart": 0,
+                  "speed": 1,
+                  "motion": {
+                    "type": "zoom",
+                    "zoomAmount": 1.08,
+                    "zoomDirection": "out",
+                    "intensity": 100,
+                    "easing": "ease-in-out"
+                  },
+                  "shotId": "shot-2"
+                },
+                {
+                  "kind": "image",
+                  "assetId": "photo-3",
+                  "versionId": "photo-3-v1",
+                  "url": "/api/media/owner/interior.jpg",
+                  "id": "clip-3",
+                  "title": "interior.jpg",
+                  "trackId": "video",
+                  "start": 6.75,
+                  "duration": 2.25,
+                  "trimStart": 0,
+                  "speed": 1,
+                  "motion": {
+                    "type": "zoom",
+                    "zoomAmount": 1.08,
+                    "zoomDirection": "in",
+                    "intensity": 100,
+                    "easing": "ease-in-out"
+                  },
+                  "shotId": "shot-2"
+                }
+              ],
+              "audioItems": [
+                {
+                  "kind": "audio",
+                  "assetId": "voiceover-1",
+                  "versionId": "voiceover-1-v1",
+                  "url": "/api/media/owner/voiceover.mp3",
+                  "id": "narration",
+                  "title": "Narration",
+                  "trackId": "narration",
+                  "start": 0,
+                  "duration": 9,
+                  "trimStart": 0,
+                  "volume": 100
+                }
+              ],
+              "captions": [],
+              "textOverlays": [],
+              "effects": [],
+              "targetDuration": 9,
+              "trackOrder": [
+                "video"
+              ],
+              "audio": [
+                {
+                  "kind": "audio",
+                  "assetId": "voiceover-1",
+                  "versionId": "voiceover-1-v1",
+                  "url": "/api/media/owner/voiceover.mp3",
+                  "id": "narration",
+                  "title": "Narration",
+                  "trackId": "narration",
+                  "start": 0,
+                  "duration": 9,
+                  "trimStart": 0,
+                  "volume": 100
+                }
+              ],
+              "overlays": []
+            },
+            "settings": {
+              "fps": 30,
+              "resolution": 1080,
+              "quality": "high"
+            },
+            "source": {
+              "id": "sm.export-video",
+              "version": "2.1.0"
+            }
+          },
+          "resultPort": "output"
+        }
+      }
+    },
+    {
+      "name": "Shows connected photos one after another when the project has no shot plan",
+      "input": {
+        "media": [
+          {
+            "kind": "image",
+            "assetId": "photo-1",
+            "versionId": "photo-1-v1",
+            "url": "/api/media/owner/front.jpg",
+            "name": "front.jpg"
+          },
+          {
+            "kind": "image",
+            "assetId": "photo-2",
+            "versionId": "photo-2-v1",
+            "url": "/api/media/owner/side.jpg",
+            "name": "side.jpg"
+          }
+        ],
+        "renderAspect": "9:16"
+      },
+      "expected": {
+        "mediaAction": {
+          "schemaVersion": 1,
+          "kind": "stillmade.media-action",
+          "operation": "final.render",
+          "request": {
+            "schemaVersion": 1,
+            "kind": "video",
+            "timeline": {
+              "schemaVersion": 1,
+              "aspect": "9:16",
+              "clips": [
+                {
+                  "kind": "image",
+                  "assetId": "photo-1",
+                  "versionId": "photo-1-v1",
+                  "url": "/api/media/owner/front.jpg",
+                  "id": "clip-1",
+                  "title": "front.jpg",
+                  "trackId": "video",
+                  "start": 0,
+                  "duration": 3,
+                  "trimStart": 0,
+                  "speed": 1,
+                  "motion": {
+                    "type": "zoom",
+                    "zoomAmount": 1.08,
+                    "zoomDirection": "in",
+                    "intensity": 100,
+                    "easing": "ease-in-out"
+                  }
+                },
+                {
+                  "kind": "image",
+                  "assetId": "photo-2",
+                  "versionId": "photo-2-v1",
+                  "url": "/api/media/owner/side.jpg",
+                  "id": "clip-2",
+                  "title": "side.jpg",
+                  "trackId": "video",
+                  "start": 3,
+                  "duration": 3,
+                  "trimStart": 0,
+                  "speed": 1,
+                  "motion": {
+                    "type": "zoom",
+                    "zoomAmount": 1.08,
+                    "zoomDirection": "out",
+                    "intensity": 100,
+                    "easing": "ease-in-out"
+                  }
+                }
+              ],
+              "audioItems": [],
+              "captions": [],
+              "textOverlays": [],
+              "effects": [],
+              "targetDuration": 6,
+              "trackOrder": [
+                "video"
+              ],
+              "audio": [],
+              "overlays": []
+            },
+            "settings": {
+              "fps": 30,
+              "resolution": 1080,
+              "quality": "high"
+            },
+            "source": {
+              "id": "sm.export-video",
+              "version": "2.1.0"
+            }
+          },
+          "resultPort": "output"
+        }
+      }
+    }
+  ],
+  "portable": {
+    "format": "stillmade-block/1",
+    "dependencies": [],
+    "sources": [
+      {
+        "kind": "original",
+        "license": "MIT",
+        "paths": [
+          "LICENSE",
+          "src/run.js"
+        ],
+        "evidence": [
+          "upstream/0/LICENSE",
+          "upstream/0/src/run.js"
+        ],
+        "changes": "Original implementation declared by the packager; no reused repository or dependency code."
+      }
+    ],
+    "files": {
+      "upstream/0/LICENSE": "MIT License\n\nCopyright (c) 2026 StillMade contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n",
+      "upstream/0/src/run.js": "// A connected timeline, else the project's timeline, is rendered as it is. With\n// neither, the video is made here from the project's shot plan, the connected\n// photos and clips, and the connected narration: the shots keep their order and\n// timings, each shows the next photo or clip, and the shots are fitted to the\n// narration's length. Media values are used exactly as the earlier Step stored them.\nconst list=value=>Array.isArray(value)?value:[];\nconst number=value=>typeof value==='number'?value:typeof value==='string'&&value.trim()?Number(value):NaN;\nconst positive=value=>{const n=number(value);return Number.isFinite(n)&&n>0?n:0;};\nconst round=value=>Math.round(value*1000)/1000;\nconst copy=value=>JSON.parse(JSON.stringify(value));\nconst pick=(value,keys)=>{const out={};for(const key of keys)if(value[key]!==undefined&&value[key]!==null)out[key]=copy(value[key]);return out;};\nconst playable=timeline=>!!timeline&&typeof timeline==='object'&&!Array.isArray(timeline)&&(list(timeline.clips).length>0||list(timeline.audioItems).length>0);\nconst settings={fps:Number(input.renderFps||30),resolution:Number(input.renderResolution||1080),quality:String(input.renderQuality||'high')};\nconst aspect=String(input.renderAspect||'16:9');\nif(![24,30,60].includes(settings.fps)||![720,1080,2160].includes(settings.resolution)||!['low','medium','high'].includes(settings.quality)||!['16:9','9:16','1:1'].includes(aspect))throw new Error('Choose approved export settings.');\nconst MEDIA_FIELDS=['kind','assetId','versionId','url','source','localKey','original','mimeType','width','height'];\n// A slow push in or out keeps a still photo alive on screen.\nconst motion=index=>({type:'zoom',zoomAmount:1.08,zoomDirection:index%2?'out':'in',intensity:100,easing:'ease-in-out'});\n\nfunction assemble(){\n const visuals=list(input.media).filter(item=>item&&typeof item==='object'&&(item.kind==='image'||item.kind==='video')&&typeof item.url==='string'&&item.url).slice(0,500);\n const shots=list(input.projectShotPlan&&input.projectShotPlan.shots).filter(shot=>shot&&typeof shot==='object'&&!Array.isArray(shot));\n if(!visuals.length)throw new Error(shots.length?`This project has ${shots.length} shot${shots.length===1?'':'s'} but no photos or clips to show. Connect them from an earlier Step, such as Import media, and run that Step.`:'There is nothing to show yet. Connect photos or clips from an earlier Step, such as Import media, or connect a timeline.');\n const voice=input.narration&&typeof input.narration==='object'&&input.narration.kind==='audio'&&typeof input.narration.url==='string'&&input.narration.url?input.narration:null;\n const spoken=voice?positive(voice.duration):0;\n const timing=shot=>{const start=number(shot.startTime),end=number(shot.endTime);return Number.isFinite(start)&&Number.isFinite(end)&&start>=0&&end>start?{start,end}:null;};\n const timed=shots.map(timing);\n const lengths=(items,length)=>{let cursor=0;return items.map((item,index)=>{const unit={shot:item.shot,start:cursor,end:cursor+length(item,index)};cursor=unit.end;return unit;});};\n let units;\n // Each timed shot lasts until the next one starts, so a pause stays with the shot before it.\n if(shots.length&&timed.every((t,index)=>t&&(!index||t.start>=timed[index-1].start)))units=shots.map((shot,index)=>({shot,start:index?timed[index].start:0,end:index<shots.length-1?timed[index+1].start:timed[index].end}));\n else if(shots.length)units=lengths(shots.map(shot=>({shot})),({shot},index)=>timed[index]?timed[index].end-timed[index].start:positive(shot.estimatedScreenTime)||positive(shot.durationMs)/1000||3);\n else units=[];\n units=units.filter(unit=>unit.end-unit.start>0.01);\n // No shot plan: each photo shows for 3 seconds and each clip for its own length (at most a minute).\n if(!units.length)units=lengths(visuals.map(()=>({shot:null})),(_,index)=>visuals[index].kind==='video'&&positive(visuals[index].duration)?Math.min(positive(visuals[index].duration),60):3);\n const planned=units[units.length-1].end,scale=spoken>0?spoken/planned:1;\n if(planned*scale>21600)throw new Error('This video would be longer than 6 hours. Shorten the shot plan or the narration.');\n const clips=[],count=units.length,media=visuals.length;\n const place=(item,from,to,shot)=>{\n  const index=clips.length,start=round(from*scale),end=round(to*scale);\n  clips.push({...pick(item,MEDIA_FIELDS),id:`clip-${index+1}`,title:String(item.name||item.label||item.title||`${item.kind==='video'?'Clip':'Photo'} ${index+1}`).slice(0,200),trackId:'video',start,duration:round(end-start),trimStart:0,speed:1,...(item.kind==='image'?{motion:motion(index)}:{}),...(shot&&typeof shot.id==='string'?{shotId:shot.id}:{})});\n };\n // More photos than shots: a shot shows its photos in turn. Fewer: a photo spans neighbouring shots.\n if(media>=count)for(let shot=0;shot<count;shot++){\n  const first=Math.floor(shot*media/count),last=Math.floor((shot+1)*media/count),unit=units[shot],step=(unit.end-unit.start)/(last-first);\n  for(let item=first;item<last;item++)place(visuals[item],unit.start+(item-first)*step,item===last-1?unit.end:unit.start+(item-first+1)*step,unit.shot);\n }\n else for(let item=0;item<media;item++){\n  const first=Math.floor(item*count/media),last=Math.floor((item+1)*count/media);\n  place(visuals[item],units[first].start,units[last-1].end,units[first].shot);\n }\n const shown=clips.reduce((max,clip)=>Math.max(max,clip.start+clip.duration),0),targetDuration=round(Math.max(shown,spoken));\n const audioItems=voice?[{...pick(voice,['kind','assetId','versionId','url','source','localKey','original','mimeType']),id:'narration',title:'Narration',trackId:'narration',start:0,duration:spoken?round(spoken):targetDuration,trimStart:0,volume:100}]:[];\n return {schemaVersion:1,aspect,clips,audioItems,captions:[],textOverlays:[],effects:[],targetDuration,trackOrder:['video']};\n}\n\nconst chosen=playable(input.input)?input.input:playable(input.projectTimeline)?input.projectTimeline:null;\nconst timeline=chosen?copy(chosen):assemble();\nconst clips=list(timeline.clips);\nconst audio=list(timeline.audioItems);\nconst overlays=[...list(timeline.captions),...list(timeline.textOverlays),...list(timeline.effects)];\nconst end=item=>Number(item.start||0)+Number(item.duration||0);\nconst targetDuration=Math.max(0,Number(timeline.targetDuration)||0,...clips.map(end),...audio.map(end),...overlays.map(end));\nif(!Number.isFinite(targetDuration)||targetDuration<=0||targetDuration>21600)throw new Error('The export duration must be between 0 and 21600 seconds.');\nreturn {mediaAction:{schemaVersion:1,kind:'stillmade.media-action',operation:'final.render',request:{schemaVersion:1,kind:'video',timeline:{...timeline,clips,audio,overlays,targetDuration},settings,source:{id:'sm.export-video',version:'2.1.0'}},resultPort:'output'}};\n"
+    },
+    "lineage": {
+      "parents": [],
+      "changes": "Packaged original Block source for StillMade."
+    }
+  }
+};