{"manifest":{"schemaVersion":1,"sdkVersion":"0.1.0","id":"sm.animated-scene","version":"2.3.4","name":"Animated Scene","description":"Build animated scenes with exact connected assets, rendered layer and media previews, timed review, and Editor output.","kind":"workspace","runtime":"javascript","entry":"src/run.js","license":"MIT","provenance":{"notice":"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"},"inputs":{"animation":{"type":"scene-document","context":"animation","primary":true,"required":false,"default":{"schemaVersion":1,"scenes":[]},"description":"The complete current Animated Scene document. Shot identity, narration timing, scene layers, assets, versions, and custom fields are retained."},"shotPlan":{"type":"shot-plan","context":"shotPlan","required":false,"default":{"schemaVersion":1,"shots":[]},"description":"Current reviewed Shots document used to build empty scene compositions when no animation document exists."},"updatedAnimation":{"type":"scene-document","required":false,"default":{"schemaVersion":1,"scenes":[]},"description":"The complete edited animation prepared in this workspace."},"commit":{"type":"boolean","default":false,"description":"Prepare the edited animation for StillMade review and Apply."},"generatedImage":{"type":"image","imageMode":"reference","required":false,"description":"An exact stored image version produced by an approved generation Block or selected from project media."},"targetShotId":{"type":"text","required":false,"default":"","description":"Shot containing the layer that receives the connected image."},"targetLayerId":{"type":"text","required":false,"default":"","description":"Layer that receives the connected image."},"attachGeneratedImage":{"type":"boolean","default":false,"description":"Attach the connected image to the selected layer while preserving prior scene versions."},"action":{"type":"text","required":false,"default":"none","description":"The Block-owned interface selects a declared host action."}},"outputs":{"animation":{"type":"scene-document","primary":true,"role":"animated_scene_document","description":"The complete edited Animated Scene document for the next Step."},"edit":{"type":"workspace-edit","description":"An exact before/after Animated Scene change reviewed before it updates the project."},"qualityAction":{"type":"approval","required":false,"role":"portable_media_action","description":"Analyze exact saved layer images."},"renderAction":{"type":"approval","required":false,"role":"portable_media_action","description":"Render composed scenes."},"qualityReport":{"type":"metadata","required":false},"editorTimeline":{"type":"timeline","role":"editor_handoff","description":"An editable timeline preserving every composed scene for a downstream Editor Step."}},"permissions":{"project":["context.animation.read","context.shotPlan.read","workspace.animation.propose"],"network":[],"filesystem":[],"secrets":[],"actions":["quality.analyze","final.render"]},"ui":[],"platforms":{"phone":{"supported":true},"browser":{"supported":true},"desktop":{"supported":true}}},"code":"const copy = value => JSON.parse(JSON.stringify(value));\nconst same = (left, right) => JSON.stringify(left === undefined ? null : left) === JSON.stringify(right === undefined ? null : right);\nconst source = copy(input.animation || {schemaVersion: 1, scenes: []});\nconst shots=Array.isArray(input.shotPlan?.shots)?input.shotPlan.shots:[];\nconst generated={schemaVersion:1,scenes:shots.map((shot,index)=>{const start=Number.isFinite(Number(shot.startTime))?Number(shot.startTime):Number(shot.startMs)/1000||0,end=Number.isFinite(Number(shot.endTime))?Number(shot.endTime):start+Math.max(1,Number(shot.estimatedScreenTime)||Number(shot.durationMs)/1000||4);return {shotId:String(shot.id||shot.shotId||'shot-'+String(index+1)),start,end,voiceoverText:String(shot.voiceoverText||shot.narration||shot.text||''),scene:{schemaVersion:1,title:String(shot.shotDescription||shot.description||'Scene '+String(index+1)),aspect:'16:9',durationMs:Math.max(1,Math.round((end-start)*1000)),layers:[],camera:{motion:String(shot.motionEffect||shot.cameraMotion||'Locked Frame')},transition:String(shot.transition||'cut')}}})};\nconst spine=source.scenes.length?source:generated;\nconst candidate = input.commit ? copy(input.updatedAnimation) : copy(spine);\nif (input.attachGeneratedImage) {\n  if (!input.generatedImage || input.generatedImage.kind !== 'image') throw new Error('Connect an approved generated image before attaching it.');\n  const record = candidate.scenes.find(item => item.shotId === input.targetShotId);\n  const layer = record && Array.isArray(record.scene && record.scene.layers) ? record.scene.layers.find(item => item.id === input.targetLayerId) : null;\n  if (!layer) throw new Error('Choose an existing scene layer for the connected image.');\n  layer.asset = copy(input.generatedImage);\n  layer.src = input.generatedImage.url;\n}\nif (!candidate || Array.isArray(candidate) || candidate.schemaVersion !== 1 || !Array.isArray(candidate.scenes) || candidate.scenes.length > 2000) {\n  throw new Error('Keep the complete version 1 Animated Scene document with up to 2,000 scenes.');\n}\nif (candidate.scenes.length !== spine.scenes.length || !candidate.scenes.every((record, index) => {\n  const previous = spine.scenes[index];\n  return record && previous && typeof record === 'object' && !Array.isArray(record) && record.shotId === previous.shotId && same(record.start, previous.start) && same(record.end, previous.end) && same(record.voiceoverText, previous.voiceoverText);\n})) throw new Error('Keep every shot ID, narration line, and narration timing unchanged. Edit the shot plan in Shots.');\nif (!candidate.scenes.every(record => record.scene && typeof record.scene === 'object' && !Array.isArray(record.scene) && (!record.scene.layers || Array.isArray(record.scene.layers) && record.scene.layers.length <= 1000 && record.scene.layers.every(layer => layer && typeof layer === 'object' && !Array.isArray(layer))) && (record.scene.durationMs === undefined || Number.isFinite(record.scene.durationMs) && record.scene.durationMs > 0 && record.scene.durationMs <= 86400000))) {\n  throw new Error('Each animated scene needs valid scene data, duration, and up to 1,000 layers.');\n}\nconst itemEnd=item=>Math.max(0,Number(item.start)||0)+Math.max(.001,Number(item.duration)||Number(item.durationMs)/1000||.001);\nconst clips=candidate.scenes.map((record,index)=>({id:record.shotId||'scene-'+index,start:Number(record.start)||0,duration:Math.max(.001,Number(record.end)-Number(record.start)||Number(record.scene?.durationMs)/1000||1),scene:copy(record.scene)}));\nconst targetDuration=Math.max(.001,...clips.map(itemEnd));\nconst editorTimeline={schemaVersion:1,activeTimelineId:'animation',clips,audioItems:Array.isArray(candidate.audioItems)?copy(candidate.audioItems):[],captions:Array.isArray(candidate.captions)?copy(candidate.captions):[],textOverlays:[],effects:[],targetDuration};\nconst outputs={animation:candidate,editorTimeline,edit:{schemaVersion:1,title:`Update Animated Scene (${candidate.scenes.length} scenes)`,field:'animation',before:source,after:candidate}};const images=candidate.scenes.flatMap(record=>(record.scene?.layers||[]).map(layer=>layer.asset)).filter(image=>image&&image.kind==='image'&&image.assetId&&image.versionId&&image.url).slice(0,16);\nif(input.action==='quality'&&images.length)outputs.qualityAction={schemaVersion:1,kind:'stillmade.media-action',operation:'quality.analyze',request:{assets:images.map(({assetId,versionId,url})=>({kind:'image',assetId,versionId,url}))},resultPort:'qualityReport'};\nif(input.action==='render')outputs.renderAction={schemaVersion:1,kind:'stillmade.media-action',operation:'final.render',request:{schemaVersion:1,kind:'video',timeline:editorTimeline,settings:{fps:30,resolution:1080,quality:'high'},source:{id:'sm.animated-scene',version:'2.3.4'}},resultPort:null};\nreturn outputs;\n","view":{"html":"<main class=\"animation-workspace\">\n  <header><div><small>Production workspace</small><h1>Animated Scene</h1><p id=\"summary\">Loading scenes…</p></div><div class=\"actions\"><button id=\"build\" type=\"button\" class=\"secondary\">Build from Shots</button><button id=\"reset\" type=\"button\" class=\"secondary\">Reset changes</button><button id=\"save\" type=\"button\" data-stillmade-action=\"run\">Review changes</button></div></header>\n  <output id=\"status\" role=\"status\" aria-live=\"polite\"></output>\n  <section><div class=\"section-title\"><h2>Connected generated image</h2></div><div id=\"handoff\"></div></section>\n  <section class=\"preview\"><div class=\"card-head\"><div><h2>Sequence preview</h2><p>Every preview frame becomes an editable Editor clip.</p></div><button id=\"prepareEditor\" type=\"button\" class=\"secondary\">Prepare Editor handoff</button></div><div id=\"sequencePreview\" class=\"preview-strip\" aria-label=\"Animated scene sequence preview\"></div><div class=\"playback\"><button id=\"advanceScene\" type=\"button\" class=\"secondary\">Advance 0.25s</button><label for=\"scenePlayhead\">Scene position</label><input id=\"scenePlayhead\" type=\"range\" min=\"0\" max=\"1\" step=\"50\" value=\"0\"><output id=\"sceneTime\" for=\"scenePlayhead\">0.0s</output></div><div id=\"sceneStage\" class=\"scene-stage\" aria-label=\"Rendered scene layer preview\"></div><div class=\"actions\"><button id=\"previewSceneImage\" type=\"button\" class=\"secondary\">Preview first scene image</button></div><img id=\"sceneImagePreview\" alt=\"Selected Animated Scene image preview\" hidden></section>\n  <section id=\"scenes\" class=\"scenes\" aria-label=\"Animated scenes\"></section>\n  <details><summary>Complete Animated Scene data</summary><p>Every engine field, asset reference, camera value, transition, version, and custom field is retained. Shot IDs, narration, and narration timing must stay unchanged.</p><label for=\"raw\">Complete Animated Scene JSON</label><textarea id=\"raw\" class=\"raw\" spellcheck=\"false\"></textarea><button id=\"applyRaw\" type=\"button\" class=\"secondary\">Apply JSON to workspace</button></details>\n<section><h2>Quality and delivery</h2><div class=\"actions\"><button id=\"qualityReview\" type=\"button\" class=\"secondary\">Review asset quality</button><button id=\"renderFinal\" type=\"button\">Render final video</button></div></section></main>\n","css":".animation-workspace{max-width:1120px;margin:0 auto;padding:8px;color:var(--fg)}header,.actions,.card-head,.row{display:flex;align-items:center;gap:10px;flex-wrap:wrap}header{justify-content:space-between;margin-bottom:14px}header h1{margin:2px 0}header p,header small,details p,output,.spine{color:var(--fg-muted)}.scenes{display:grid;gap:12px}.preview{margin:12px 0;padding:16px;border:1px solid var(--border-tok);border-radius:var(--r-3);background:var(--bg-elev-1)}.playback{display:grid;grid-template-columns:auto auto minmax(140px,1fr) auto;align-items:center;gap:10px;margin:10px 0}.playback label{margin:0}.preview-strip{display:grid;grid-auto-flow:column;grid-auto-columns:minmax(150px,1fr);gap:10px;overflow-x:auto;padding:8px 0}.preview-frame{display:grid;gap:6px;min-height:110px;padding:14px;border:1px solid var(--border-strong);border-radius:var(--r-2);background:var(--bg);align-content:center}.preview-frame span{color:var(--fg-muted)}.preview-frame.active{outline:3px solid var(--accent);outline-offset:2px}.scene-stage{position:relative;min-height:320px;overflow:hidden;border:1px solid var(--border-strong);border-radius:var(--r-3);background:var(--bg);margin-top:12px}.scene-layer{position:absolute;display:grid;place-items:center;min-width:44px;min-height:44px;padding:8px;border:1px solid var(--border-strong);border-radius:var(--r-2);background:var(--bg-elev-1);overflow:hidden;text-overflow:ellipsis}.scene-layer.asset{border-style:double}.x-0{left:0%}.x-1{left:9%}.x-2{left:18%}.x-3{left:27%}.x-4{left:36%}.x-5{left:45%}.x-6{left:54%}.x-7{left:63%}.x-8{left:72%}.x-9{left:81%}.x-10{left:90%}.y-0{top:0%}.y-1{top:8%}.y-2{top:16%}.y-3{top:24%}.y-4{top:32%}.y-5{top:40%}.y-6{top:48%}.y-7{top:56%}.y-8{top:64%}.y-9{top:72%}.y-10{top:80%}.size-s{width:14%}.size-m{width:24%}.size-l{width:38%}.card,details{padding:16px;border:1px solid var(--border-tok);border-radius:var(--r-3);background:var(--bg-elev-1)}.card-head{justify-content:space-between}.card h2{margin:0;font-size:18px}.layers{display:grid;gap:8px;margin-top:12px}.layer{padding:10px;border:1px solid var(--border-tok);border-radius:var(--r-2);background:var(--bg)}.grid{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:10px}label{display:grid;gap:5px;margin:8px 0;font-size:13px;font-weight:600}input,textarea{width:100%;background:var(--bg)}textarea{min-height:76px;resize:vertical}.wide{grid-column:1/-1}.secondary{background:transparent;color:var(--fg)}.danger{background:transparent;color:var(--signal)}.raw{min-height:400px;font-family:var(--font-mono);font-size:12px}output{display:block;min-height:24px;margin:8px 2px}\n@media(max-width:820px){.playback{grid-template-columns:auto 1fr}.playback label{grid-column:1/-1}.grid{grid-template-columns:repeat(2,minmax(0,1fr))}}@media(max-width:560px){.animation-workspace{padding:0}.grid{grid-template-columns:1fr}.actions{width:100%}.actions button{flex:1}.preview,.card,details{padding:12px}}\n","javascript":"const status=document.getElementById('status'),summary=document.getElementById('summary'),raw=document.getElementById('raw'),save=document.getElementById('save'),build=document.getElementById('build');\nlet source={schemaVersion:1,scenes:[]},draft={schemaVersion:1,scenes:[]},connectedImage=null,shotPlan={schemaVersion:1,shots:[]},busy=false,revision=0,selectedScene=0,scenePlayhead=0;\nconst clone=value=>JSON.parse(JSON.stringify(value));\nconst text=value=>value===undefined||value===null?'':String(value);\nconst plan=()=>({schemaVersion:1,scenes:(Array.isArray(shotPlan.shots)?shotPlan.shots:[]).map((shot,index)=>{const start=Number.isFinite(Number(shot.startTime))?Number(shot.startTime):Number(shot.startMs)/1000||0,end=Number.isFinite(Number(shot.endTime))?Number(shot.endTime):start+Math.max(1,Number(shot.estimatedScreenTime)||Number(shot.durationMs)/1000||4);return {shotId:text(shot.id||shot.shotId||'shot-'+String(index+1)),start,end,voiceoverText:text(shot.voiceoverText||shot.narration||shot.text),scene:{schemaVersion:1,title:text(shot.shotDescription||shot.description||'Scene '+String(index+1)),aspect:'16:9',durationMs:Math.max(1,Math.round((end-start)*1000)),layers:[],camera:{motion:text(shot.motionEffect||shot.cameraMotion||'Locked Frame')},transition:text(shot.transition||'cut')}}})});\nconst field=(label,action,value,type='text',wide=false)=>({tag:'label',className:wide?'wide':'',children:[{tag:'span',text:label},{tag:'input',type,action,value:Number.isFinite(value)?value:text(value),disabled:busy,label}]});\nconst layerCard=(layer,sceneIndex,layerIndex)=>({tag:'article',className:'layer',children:[{tag:'div',className:'card-head',children:[{tag:'strong',text:text(layer.label)||text(layer.id)||'Layer '+String(layerIndex+1)},{tag:'div',className:'row',children:[connectedImage?{tag:'button',action:'attach-image:'+String(sceneIndex)+':'+String(layerIndex),text:'Use connected image',className:'secondary',disabled:busy}:null,{tag:'button',action:'clear-asset:'+String(sceneIndex)+':'+String(layerIndex),text:'Clear asset',className:'secondary',disabled:busy||!(layer.asset||layer.src)},{tag:'button',action:'remove-layer:'+String(sceneIndex)+':'+String(layerIndex),text:'Remove',className:'danger',disabled:busy}].filter(Boolean)}]},{tag:'div',className:'grid',children:[field('Layer ID','layer-id:'+String(sceneIndex)+':'+String(layerIndex),layer.id),field('Label','layer-label:'+String(sceneIndex)+':'+String(layerIndex),layer.label),field('Depth','layer-depth:'+String(sceneIndex)+':'+String(layerIndex),layer.depth,'number'),field('X','layer-x:'+String(sceneIndex)+':'+String(layerIndex),layer.transform&&layer.transform.x,'number'),field('Y','layer-y:'+String(sceneIndex)+':'+String(layerIndex),layer.transform&&layer.transform.y,'number'),field('Scale','layer-scale:'+String(sceneIndex)+':'+String(layerIndex),layer.transform&&layer.transform.scale,'number'),field('Rotation','layer-rotation:'+String(sceneIndex)+':'+String(layerIndex),layer.transform&&layer.transform.rot,'number'),field('Appears (ms)','layer-appear:'+String(sceneIndex)+':'+String(layerIndex),layer.appearMs,'number'),field('Leaves (ms)','layer-leave:'+String(sceneIndex)+':'+String(layerIndex),layer.leaveMs,'number'),field('Asset ID','layer-asset:'+String(sceneIndex)+':'+String(layerIndex),layer.asset&&layer.asset.assetId),field('Version ID','layer-version:'+String(sceneIndex)+':'+String(layerIndex),layer.asset&&layer.asset.versionId),field('Media source','layer-src:'+String(sceneIndex)+':'+String(layerIndex),layer.src)]}]});\nconst sceneCard=(record,index)=>{const scene=record.scene||{},layers=Array.isArray(scene.layers)?scene.layers:[];return {tag:'article',className:'card',children:[{tag:'div',className:'card-head',children:[{tag:'h2',text:'Scene '+String(index+1)+' · '+text(record.shotId)},{tag:'button',action:'add-layer:'+String(index),text:'Add layer',className:'secondary',disabled:busy}]},{tag:'p',className:'spine',text:text(record.start)+' → '+text(record.end)+' · '+text(record.voiceoverText)},{tag:'div',className:'grid',children:[field('Title','scene-title:'+String(index),scene.title),field('Aspect','scene-aspect:'+String(index),scene.aspect),field('Duration (ms)','scene-duration:'+String(index),scene.durationMs,'number')]},{tag:'div',className:'layers',children:layers.length?layers.map((layer,layerIndex)=>layerCard(layer,index,layerIndex)):[{tag:'p',text:'No layers in this scene.'}]},{tag:'p',className:'spine',text:Array.isArray(record.versions)?String(record.versions.length)+' retained version'+(record.versions.length===1?'':'s'):''}]}};\nconst ensure=()=>{if(!draft||Array.isArray(draft)||draft.schemaVersion!==1)draft={schemaVersion:1,scenes:[]};if(!Array.isArray(draft.scenes))draft.scenes=[]};\nconst draw=()=>{ensure();selectedScene=Math.max(0,Math.min(Math.max(0,draft.scenes.length-1),selectedScene));StillMade.render('sequencePreview',draft.scenes.slice(0,50).map((record,index)=>({tag:'article',className:'preview-frame'+(index===selectedScene?' active':''),children:[{tag:'strong',text:'Scene '+String(index+1)},{tag:'span',text:text(record.scene&&record.scene.title)||text(record.shotId)},{tag:'span',text:String((record.scene&&record.scene.layers||[]).length)+' layers · '+String(Math.max(1,Math.round((Number(record.end)-Number(record.start))*1000)||Number(record.scene&&record.scene.durationMs)||1))+' ms'},{tag:'button',action:'select-scene:'+String(index),text:'View scene',className:'secondary'}]})));const previewRecord=draft.scenes.find((item,index)=>index===selectedScene),previewLayers=(previewRecord&&previewRecord.scene&&previewRecord.scene.layers||[]).slice(0,100);StillMade.render('sceneStage',previewLayers.map((layer,index)=>{const transform=layer.transform||{},x=Math.round(Math.max(0,Math.min(1,Number(transform.x)||.5))*10),y=Math.round(Math.max(0,Math.min(1,Number(transform.y)||.5))*10),scale=Number(transform.scale)||1,sizeClass=scale<.75?' size-s':scale>1.35?' size-l':' size-m';return {tag:'div',id:'scene-layer-'+String(index),className:'scene-layer x-'+String(x)+' y-'+String(y)+sizeClass+(layer.asset||layer.src?' asset':''),text:text(layer.label||layer.id||'Layer '+String(index+1))}}));updateScenePlayback();StillMade.render('handoff',connectedImage?[{tag:'p',className:'hint',text:'Ready: '+text(connectedImage.assetId)+' · version '+text(connectedImage.versionId)},{tag:'p',className:'hint',text:'Choose Use connected image on a scene layer.'}]:[{tag:'p',className:'hint',text:'Connect the output of Generate image to attach an approved stored result. Provider credentials and charging stay outside this Block.'}]);StillMade.render('scenes',draft.scenes.length?draft.scenes.map(sceneCard):[{tag:'p',text:'No composed scenes yet. Build scenes from the Shots Step first.'}]);raw.value=JSON.stringify(draft,null,2);summary.textContent=String(draft.scenes.length)+' composed scene'+(draft.scenes.length===1?'':'s');save.disabled=busy;build.disabled=busy||!shotPlan.shots?.length;document.getElementById('reset').disabled=busy};\nconst changed=()=>{revision+=1;raw.value=JSON.stringify(draft,null,2);status.textContent='Changes are local until you choose Review changes.'};\nStillMade.onAction(event=>{if(busy)return;ensure();const parts=event.action.split(':'),kind=parts[0],sceneIndex=Number(parts[1]),layerIndex=Number(parts[2]),record=draft.scenes.find((item,position)=>position===sceneIndex),scene=record&&record.scene,layer=scene&&Array.isArray(scene.layers)?scene.layers.find((item,position)=>position===layerIndex):null;if(!scene)return;\n if(kind==='select-scene'){selectedScene=sceneIndex;scenePlayhead=0;draw();status.textContent='Showing scene '+String(sceneIndex+1)+' in the rendered layer preview.';return}if(kind==='add-layer'){if(!Array.isArray(scene.layers))scene.layers=[];scene.layers=[...scene.layers,{id:'portable-layer-'+String(scene.layers.length+1)+'-'+String(revision+1),label:'New layer',params:{},transform:{x:0.5,y:0.5,scale:1,rot:0},depth:0.5,z:scene.layers.length+1}];changed();draw();return}if(kind==='remove-layer'&&layer){scene.layers=scene.layers.filter((item,position)=>position!==layerIndex);changed();draw();return}\n if(kind==='clear-asset'&&layer){delete layer.asset;delete layer.src;changed();draw();status.textContent='Layer asset cleared locally. Undo by resetting or use Complete data.';return}\n if(kind==='attach-image'&&layer&&connectedImage){layer.asset=clone(connectedImage);layer.src=connectedImage.url;changed();draw();status.textContent='Connected image attached with its exact asset and version identity.';return}\n if(kind==='scene-title')scene.title=event.value;if(kind==='scene-aspect')scene.aspect=event.value;if(kind==='scene-duration')scene.durationMs=Math.max(1,Number(event.value)||1);\n if(layer){if(kind==='layer-id')layer.id=event.value;if(kind==='layer-label')layer.label=event.value;if(kind==='layer-depth')layer.depth=Number(event.value);if(kind==='layer-appear')layer.appearMs=Math.max(0,Number(event.value)||0);if(kind==='layer-leave')layer.leaveMs=event.value===''?null:Math.max(0,Number(event.value)||0);if(kind==='layer-asset'){if(!layer.asset||Array.isArray(layer.asset))layer.asset={kind:'image'};layer.asset.assetId=event.value}if(kind==='layer-version'){if(!layer.asset||Array.isArray(layer.asset))layer.asset={kind:'image'};layer.asset.versionId=event.value}if(kind==='layer-src')layer.src=event.value;if(!layer.transform||Array.isArray(layer.transform))layer.transform={x:0.5,y:0.5,scale:1,rot:0};if(kind==='layer-x')layer.transform.x=Number(event.value);if(kind==='layer-y')layer.transform.y=Number(event.value);if(kind==='layer-scale')layer.transform.scale=Number(event.value);if(kind==='layer-rotation')layer.transform.rot=Number(event.value)}changed()});\nbuild.addEventListener('click',()=>{if(!busy){draft=plan();changed();draw();status.textContent='Built editable scene compositions from the current Shots spine.'}});\ndocument.getElementById('applyRaw').addEventListener('click',()=>{if(busy)return;try{const value=JSON.parse(raw.value);if(!value||Array.isArray(value)||value.schemaVersion!==1||!Array.isArray(value.scenes))throw Error('Animated Scene JSON must be a version 1 object with scenes.');draft=clone(value);changed();draw();status.textContent='Complete Animated Scene data applied locally. Shot and narration fields will be checked before review.'}catch(error){status.textContent=error.message}});\ndocument.getElementById('reset').addEventListener('click',()=>{if(!busy){draft=clone(source);revision+=1;draw();status.textContent='Changes reset to the current Animated Scene document.'}});\nsave.addEventListener('click',async()=>{if(busy)return;const started=revision;busy=true;draw();status.textContent='Checking scenes and the narration spine…';try{const result=await StillMade.run({animation:source,updatedAnimation:draft,commit:true});draft=clone(result.animation);if(started===revision)status.textContent='Animated Scene changes are ready below. Review the before and after, then choose Apply.'}catch(error){status.textContent=error.message||'Animated Scene changes could not be prepared.'}finally{busy=false;draw()}});\nStillMade.onInput(values=>{source=clone(values.animation||{schemaVersion:1,scenes:[]});shotPlan=clone(values.shotPlan||{schemaVersion:1,shots:[]});draft=source.scenes?.length?clone(source):plan();connectedImage=values.generatedImage?clone(values.generatedImage):null;revision+=1;draw();status.textContent='Edit scene composition and layers. Shot IDs, narration, timing, assets, versions, and custom fields are retained.'});\n\nconst mediaAction=async action=>{if(busy)return;busy=true;draw();try{await StillMade.run({animation:source,updatedAnimation:draft,commit:false,action});status.textContent='The approved action is ready below.'}catch(error){status.textContent=error.message||'The media action could not be prepared.'}finally{busy=false;draw()}};document.getElementById('qualityReview').addEventListener('click',()=>mediaAction('quality'));document.getElementById('renderFinal').addEventListener('click',()=>mediaAction('render'));\n\ndocument.getElementById('prepareEditor').addEventListener('click',async()=>{if(busy)return;busy=true;draw();status.textContent='Preparing the editable timeline…';try{const result=await StillMade.run({animation:source,updatedAnimation:draft,commit:true});status.textContent=String(result.editorTimeline.clips.length)+' animated clips are ready below for a connected Editor Step.'}catch(error){status.textContent=error.message||'The Editor handoff could not be prepared.'}finally{busy=false;draw()}});\n\nconst updateScenePlayback=()=>{const record=draft.scenes.find((item,index)=>index===selectedScene),duration=Math.max(1,Number(record&&record.scene&&record.scene.durationMs)||Math.round(((Number(record&&record.end)||0)-(Number(record&&record.start)||0))*1000)||1),slider=document.getElementById('scenePlayhead');scenePlayhead=Math.max(0,Math.min(duration,scenePlayhead));slider.max=String(duration);slider.value=String(scenePlayhead);document.getElementById('sceneTime').textContent=(scenePlayhead/1000).toFixed(1)+'s';((record&&record.scene&&record.scene.layers)||[]).slice(0,100).forEach((layer,index)=>{const node=document.getElementById('scene-layer-'+String(index));if(node){const appear=Math.max(0,Number(layer.appearMs)||0),leave=layer.leaveMs==null?Infinity:Math.max(0,Number(layer.leaveMs)||0);node.hidden=scenePlayhead<appear||scenePlayhead>leave}})};document.getElementById('scenePlayhead').addEventListener('input',event=>{scenePlayhead=Number(event.target.value)||0;updateScenePlayback()});document.getElementById('advanceScene').addEventListener('click',()=>{const duration=Number(document.getElementById('scenePlayhead').max)||1;scenePlayhead=scenePlayhead+250>=duration?0:scenePlayhead+250;updateScenePlayback()});\n\ndocument.getElementById('previewSceneImage').addEventListener('click',async()=>{const record=draft.scenes.find((item,index)=>index===selectedScene),layer=(record&&record.scene&&record.scene.layers||[]).find(item=>item&&item.asset&&item.asset.kind==='image'&&item.asset.url);if(!layer){status.textContent='Attach an exact connected image to this scene first.';return}try{const preview=await StillMade.previewImage(layer.asset),image=document.getElementById('sceneImagePreview');image.src=preview.url;image.hidden=false;status.textContent='Showing the trusted bounded preview for this scene asset.'}catch(error){status.textContent=error.message||'This scene image preview is unavailable.'}});\n"},"tests":[{"name":"Retain the complete Animated Scene document","input":{"animation":{"schemaVersion":1,"scenes":[{"shotId":"shot-1","start":0,"end":4,"voiceoverText":"Keep narration","scene":{"title":"Opening","durationMs":4000,"aspect":"16:9","layers":[{"id":"hero","label":"Hero","asset":{"assetId":"asset-1","versionId":"v2"},"transform":{"x":0.5,"y":0.6,"scale":1,"rot":0},"custom":{"keep":true}}]},"versions":[{"label":"Original","scene":{"durationMs":4000}}]}]},"updatedAnimation":{"schemaVersion":1,"scenes":[]},"commit":false},"expected":{"animation":{"schemaVersion":1,"scenes":[{"shotId":"shot-1","start":0,"end":4,"voiceoverText":"Keep narration","scene":{"title":"Opening","durationMs":4000,"aspect":"16:9","layers":[{"id":"hero","label":"Hero","asset":{"assetId":"asset-1","versionId":"v2"},"transform":{"x":0.5,"y":0.6,"scale":1,"rot":0},"custom":{"keep":true}}]},"versions":[{"label":"Original","scene":{"durationMs":4000}}]}]},"editorTimeline":{"schemaVersion":1,"activeTimelineId":"animation","clips":[{"id":"shot-1","start":0,"duration":4,"scene":{"title":"Opening","durationMs":4000,"aspect":"16:9","layers":[{"id":"hero","label":"Hero","asset":{"assetId":"asset-1","versionId":"v2"},"transform":{"x":0.5,"y":0.6,"scale":1,"rot":0},"custom":{"keep":true}}]}}],"audioItems":[],"captions":[],"textOverlays":[],"effects":[],"targetDuration":4},"edit":{"schemaVersion":1,"title":"Update Animated Scene (1 scenes)","field":"animation","before":{"schemaVersion":1,"scenes":[{"shotId":"shot-1","start":0,"end":4,"voiceoverText":"Keep narration","scene":{"title":"Opening","durationMs":4000,"aspect":"16:9","layers":[{"id":"hero","label":"Hero","asset":{"assetId":"asset-1","versionId":"v2"},"transform":{"x":0.5,"y":0.6,"scale":1,"rot":0},"custom":{"keep":true}}]},"versions":[{"label":"Original","scene":{"durationMs":4000}}]}]},"after":{"schemaVersion":1,"scenes":[{"shotId":"shot-1","start":0,"end":4,"voiceoverText":"Keep narration","scene":{"title":"Opening","durationMs":4000,"aspect":"16:9","layers":[{"id":"hero","label":"Hero","asset":{"assetId":"asset-1","versionId":"v2"},"transform":{"x":0.5,"y":0.6,"scale":1,"rot":0},"custom":{"keep":true}}]},"versions":[{"label":"Original","scene":{"durationMs":4000}}]}]}}}},{"name":"Prepare one exact Animated Scene update","input":{"animation":{"schemaVersion":1,"scenes":[{"shotId":"shot-1","start":0,"end":4,"voiceoverText":"Keep narration","scene":{"title":"Opening","durationMs":4000,"layers":[{"id":"hero","label":"Hero","depth":0.6,"transform":{"x":0.5,"y":0.5,"scale":1,"rot":0}}]}}]},"updatedAnimation":{"schemaVersion":1,"scenes":[{"shotId":"shot-1","start":0,"end":4,"voiceoverText":"Keep narration","scene":{"title":"Closer opening","durationMs":4000,"layers":[{"id":"hero","label":"Hero close","depth":0.7,"transform":{"x":0.55,"y":0.5,"scale":1.2,"rot":0}}]}}]},"commit":true},"expected":{"animation":{"schemaVersion":1,"scenes":[{"shotId":"shot-1","start":0,"end":4,"voiceoverText":"Keep narration","scene":{"title":"Closer opening","durationMs":4000,"layers":[{"id":"hero","label":"Hero close","depth":0.7,"transform":{"x":0.55,"y":0.5,"scale":1.2,"rot":0}}]}}]},"editorTimeline":{"schemaVersion":1,"activeTimelineId":"animation","clips":[{"id":"shot-1","start":0,"duration":4,"scene":{"title":"Closer opening","durationMs":4000,"layers":[{"id":"hero","label":"Hero close","depth":0.7,"transform":{"x":0.55,"y":0.5,"scale":1.2,"rot":0}}]}}],"audioItems":[],"captions":[],"textOverlays":[],"effects":[],"targetDuration":4},"edit":{"schemaVersion":1,"title":"Update Animated Scene (1 scenes)","field":"animation","before":{"schemaVersion":1,"scenes":[{"shotId":"shot-1","start":0,"end":4,"voiceoverText":"Keep narration","scene":{"title":"Opening","durationMs":4000,"layers":[{"id":"hero","label":"Hero","depth":0.6,"transform":{"x":0.5,"y":0.5,"scale":1,"rot":0}}]}}]},"after":{"schemaVersion":1,"scenes":[{"shotId":"shot-1","start":0,"end":4,"voiceoverText":"Keep narration","scene":{"title":"Closer opening","durationMs":4000,"layers":[{"id":"hero","label":"Hero close","depth":0.7,"transform":{"x":0.55,"y":0.5,"scale":1.2,"rot":0}}]}}]}}}},{"name":"Build scene compositions from the reviewed shot plan","input":{"animation":{"schemaVersion":1,"scenes":[]},"shotPlan":{"schemaVersion":1,"shots":[{"id":"opening","voiceoverText":"Welcome to the city.","shotDescription":"A wide city view","startTime":0,"endTime":4,"motionEffect":"Push In"}]},"updatedAnimation":{"schemaVersion":1,"scenes":[]},"commit":false,"action":"none"},"expected":{"animation":{"schemaVersion":1,"scenes":[{"shotId":"opening","start":0,"end":4,"voiceoverText":"Welcome to the city.","scene":{"schemaVersion":1,"title":"A wide city view","aspect":"16:9","durationMs":4000,"layers":[],"camera":{"motion":"Push In"},"transition":"cut"}}]},"editorTimeline":{"schemaVersion":1,"activeTimelineId":"animation","clips":[{"id":"opening","start":0,"duration":4,"scene":{"schemaVersion":1,"title":"A wide city view","aspect":"16:9","durationMs":4000,"layers":[],"camera":{"motion":"Push In"},"transition":"cut"}}],"audioItems":[],"captions":[],"textOverlays":[],"effects":[],"targetDuration":4},"edit":{"schemaVersion":1,"title":"Update Animated Scene (1 scenes)","field":"animation","before":{"schemaVersion":1,"scenes":[]},"after":{"schemaVersion":1,"scenes":[{"shotId":"opening","start":0,"end":4,"voiceoverText":"Welcome to the city.","scene":{"schemaVersion":1,"title":"A wide city view","aspect":"16:9","durationMs":4000,"layers":[],"camera":{"motion":"Push In"},"transition":"cut"}}]}}}}]}