@aelionsdk/sdk 0.1.0-beta.1 → 1.0.0-rc.1

package/README.md

@@ -2,14 +2,14 @@
 
 Browser-first video editing, preview, playback and export APIs for AelionSDK.
 
-## Install the public Beta
+## Install the 1.0 Release Candidate
 
 ```bash
 npm install @aelionsdk/sdk@next
 npm install --save-dev @aelionsdk/vite-plugin@next vite
 ```
 
-`next` currently resolves to `0.1.0-beta.1`. Pin the exact version after
+`next` currently resolves to `1.0.0-rc.1`. Pin the exact version after
 validation instead of following a moving prerelease tag.
 
 ## Vite setup
@@ -52,9 +52,24 @@ See the [AelionSDK documentation](https://foyonaczy.github.io/AelionSDK/) for
 media registration, Composition APIs, preview, local export, persistent
 checkpoints, deployment headers and capability preflight.
 
-## Beta contract
+## Migrate WebAV or Diffusion projects
 
-The Beta is tested on the automated Chromium and Firefox matrix. Playwright
+The package also installs `aelion-migrate`. It produces a validated Project
+and a versioned loss report; strict mode never writes a Project when rendering
+semantics cannot be preserved.
+
+```bash
+pnpm exec aelion-migrate --from webav --input webav.json --out project.aelion.json
+pnpm exec aelion-migrate --from diffusion --input checkpoint.json \
+  --assets assets.json --dry-run
+```
+
+Use the `@aelionsdk/sdk/migrate-cli` subpath to call the same file migration
+API from Node.js.
+
+## Release Candidate contract
+
+The RC is tested on the automated Chromium and Firefox matrix. Playwright
 WebKit and a mobile viewport cover public capability and fallback contracts;
 physical Safari, iOS and Android devices are not yet certified. Local color
 execution is RGBA8 SDR. Public APIs may still change before the first stable

package/dist/default-schemas.js

@@ -6,7 +6,7 @@ function deepFreeze(value) {
     }
     return value;
 }
-const projectSchema = JSON.parse(String.raw `{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://schemas.aelion.dev/project/v1.json","title":"Aelion Project Document v1","type":"object","additionalProperties":false,"required":["$schema","schemaVersion","projectId","metadata","settings","assets","sequences","tracks","items","materialInstances","transitions","markers","linkGroups","extensions"],"properties":{"$schema":{"const":"https://schemas.aelion.dev/project/v1.json"},"schemaVersion":{"const":"1.0.0"},"projectId":{"$ref":"#/$defs/entityId"},"metadata":{"$ref":"#/$defs/jsonObject"},"settings":{"$ref":"#/$defs/settings"},"assets":{"$ref":"#/$defs/assetMap"},"sequences":{"$ref":"#/$defs/sequenceMap"},"tracks":{"$ref":"#/$defs/trackMap"},"items":{"$ref":"#/$defs/itemMap"},"materialInstances":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"https://schemas.aelion.dev/material/instance/v1.json"}},"transitions":{"$ref":"#/$defs/transitionMap"},"markers":{"$ref":"#/$defs/markerMap"},"linkGroups":{"$ref":"#/$defs/linkGroupMap"},"extensions":{"$ref":"#/$defs/extensions"}},"$defs":{"entityId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z][A-Za-z0-9._:-]*$"},"safeInteger":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"timeUs":{"type":"integer","minimum":0,"maximum":9007199254740991},"positiveDurationUs":{"type":"integer","minimum":1,"maximum":9007199254740991},"jsonValue":{"oneOf":[{"type":"null"},{"type":"boolean"},{"type":"number"},{"type":"string"},{"type":"array","maxItems":16384,"items":{"$ref":"#/$defs/jsonValue"}},{"type":"object","maxProperties":4096,"additionalProperties":{"$ref":"#/$defs/jsonValue"}}]},"jsonObject":{"type":"object","maxProperties":4096,"additionalProperties":{"$ref":"#/$defs/jsonValue"}},"extensions":{"type":"object","maxProperties":4096,"propertyNames":{"type":"string","pattern":"^[a-z0-9]+(?:\\.[a-z0-9-]+)+$"},"additionalProperties":{"$ref":"#/$defs/jsonValue"}},"rational":{"type":"object","additionalProperties":false,"required":["numerator","denominator"],"properties":{"numerator":{"type":"integer","minimum":1,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":1,"maximum":9007199254740991}}},"range":{"type":"object","additionalProperties":false,"required":["startUs","durationUs"],"properties":{"startUs":{"$ref":"#/$defs/timeUs"},"durationUs":{"$ref":"#/$defs/positiveDurationUs"}}},"color":{"type":"object","additionalProperties":false,"required":["space","rgba"],"properties":{"space":{"enum":["srgb-linear","display-p3-linear","rec2020-linear"]},"rgba":{"type":"array","minItems":4,"maxItems":4,"items":{"type":"number"}}}},"vec2":{"type":"object","additionalProperties":false,"required":["x","y"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"animation":{"type":"object","additionalProperties":false,"required":["animation"],"properties":{"animation":{"type":"object","additionalProperties":false,"required":["timeSpace","preInfinity","postInfinity","keyframes"],"properties":{"timeSpace":{"enum":["item","sequence"]},"preInfinity":{"enum":["hold","linear","none","cycle","ping-pong"]},"postInfinity":{"enum":["hold","linear","none","cycle","ping-pong"]},"keyframes":{"type":"array","minItems":1,"maxItems":4096,"items":{"type":"object","additionalProperties":false,"required":["timeUs","value","interpolation"],"properties":{"timeUs":{"$ref":"#/$defs/timeUs"},"value":{"$ref":"#/$defs/jsonValue"},"interpolation":{"enum":["hold","linear","cubic-bezier"]},"easing":{"type":"object","required":["type"],"properties":{"type":{"enum":["linear","steps","cubic-bezier"]},"count":{"type":"integer","minimum":1},"position":{"enum":["start","end"]},"x1":{"type":"number"},"y1":{"type":"number"},"x2":{"type":"number"},"y2":{"type":"number"}},"additionalProperties":false}}}}}}}},"animatableNumber":{"oneOf":[{"type":"number"},{"$ref":"#/$defs/animation"}]},"animatableVec2":{"oneOf":[{"$ref":"#/$defs/vec2"},{"$ref":"#/$defs/animation"}]},"settings":{"type":"object","additionalProperties":false,"required":["defaultSequenceId","defaultStillDurationUs","missingAssetPolicy","missingMaterialPolicy","missingPluginPolicy"],"properties":{"defaultSequenceId":{"$ref":"#/$defs/entityId"},"defaultStillDurationUs":{"$ref":"#/$defs/positiveDurationUs"},"locale":{"type":"string","minLength":1,"maxLength":128},"timezone":{"type":"string","minLength":1,"maxLength":128},"missingAssetPolicy":{"enum":["placeholder","error"]},"missingMaterialPolicy":{"enum":["placeholder","error"]},"missingPluginPolicy":{"enum":["placeholder","error"]}}},"assetLocator":{"oneOf":[{"type":"object","additionalProperties":false,"required":["type","uri"],"properties":{"type":{"const":"url"},"uri":{"type":"string","minLength":1,"maxLength":8192}}},{"type":"object","additionalProperties":false,"required":["type","bindingId"],"properties":{"type":{"const":"runtime-binding"},"bindingId":{"$ref":"#/$defs/entityId"}}},{"type":"object","additionalProperties":false,"required":["type","path"],"properties":{"type":{"const":"opfs"},"path":{"type":"string","minLength":1,"maxLength":4096}}},{"type":"object","additionalProperties":false,"required":["type","mimeType","base64"],"properties":{"type":{"const":"data"},"mimeType":{"type":"string","minLength":1,"maxLength":256},"base64":{"type":"string","maxLength":349528}}}]},"asset":{"type":"object","additionalProperties":false,"required":["id","kind","locator"],"properties":{"id":{"$ref":"#/$defs/entityId"},"kind":{"enum":["video","audio","image","font","lut","binary"]},"name":{"type":"string","maxLength":256},"locator":{"$ref":"#/$defs/assetLocator"},"contentHash":{"type":"object","additionalProperties":false,"required":["algorithm","value"],"properties":{"algorithm":{"const":"sha256"},"value":{"type":"string","pattern":"^[0-9a-f]{64}$"}}},"byteLength":{"type":"integer","minimum":0,"maximum":9007199254740991},"mimeType":{"type":"string","minLength":1,"maxLength":256},"representations":{"type":"array","maxItems":32,"items":{"type":"object","maxProperties":4096,"additionalProperties":true,"required":["id","role","locator"],"properties":{"id":{"$ref":"#/$defs/entityId"},"role":{"enum":["original","proxy","thumbnail","waveform"]},"locator":{"$ref":"#/$defs/assetLocator"}}}},"probeHint":{"type":"object","additionalProperties":false,"properties":{"durationUs":{"$ref":"#/$defs/positiveDurationUs"},"width":{"type":"integer","minimum":1,"maximum":65535},"height":{"type":"integer","minimum":1,"maximum":65535},"videoCodec":{"type":"string","maxLength":256},"audioCodec":{"type":"string","maxLength":256}}},"metadata":{"$ref":"#/$defs/jsonObject"},"extensions":{"$ref":"#/$defs/extensions"}}},"assetMap":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/asset"}},"sequence":{"type":"object","additionalProperties":false,"required":["id","format","duration","trackIds","transitionIds","materialInstanceIds","markerIds"],"properties":{"id":{"$ref":"#/$defs/entityId"},"name":{"type":"string","maxLength":256},"format":{"type":"object","additionalProperties":false,"required":["width","height","pixelAspectRatio","frameRate","sampleRate","channelLayout","workingColorSpace","backgroundColor"],"properties":{"width":{"type":"integer","minimum":1,"maximum":65535},"height":{"type":"integer","minimum":1,"maximum":65535},"pixelAspectRatio":{"$ref":"#/$defs/rational"},"frameRate":{"$ref":"#/$defs/rational"},"sampleRate":{"enum":[44100,48000,96000]},"channelLayout":{"enum":["mono","stereo","5.1"]},"workingColorSpace":{"enum":["srgb-linear","display-p3-linear","rec2020-linear"]},"transferFunction":{"enum":["srgb","gamma22","pq","hlg"],"default":"srgb"},"bitDepth":{"enum":[8,10],"default":8},"backgroundColor":{"$ref":"#/$defs/color"}}},"duration":{"oneOf":[{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"const":"content"}}},{"type":"object","additionalProperties":false,"required":["mode","durationUs","overflow"],"properties":{"mode":{"const":"fixed"},"durationUs":{"$ref":"#/$defs/timeUs"},"overflow":{"enum":["clip","allow"]}}}]},"trackIds":{"$ref":"#/$defs/idList"},"transitionIds":{"$ref":"#/$defs/idList"},"materialInstanceIds":{"$ref":"#/$defs/idList"},"markerIds":{"$ref":"#/$defs/idList"},"extensions":{"$ref":"#/$defs/extensions"}}},"sequenceMap":{"type":"object","minProperties":1,"maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/sequence"}},"idList":{"type":"array","maxItems":16384,"items":{"$ref":"#/$defs/entityId"}},"track":{"type":"object","additionalProperties":false,"required":["id","sequenceId","kind","enabled","locked","itemIds","materialInstanceIds"],"properties":{"id":{"$ref":"#/$defs/entityId"},"sequenceId":{"$ref":"#/$defs/entityId"},"kind":{"enum":["visual","audio","caption"]},"name":{"type":"string","maxLength":256},"enabled":{"type":"boolean"},"locked":{"type":"boolean"},"itemIds":{"$ref":"#/$defs/idList"},"materialInstanceIds":{"$ref":"#/$defs/idList"},"audio":{"type":"object","additionalProperties":false,"required":["gainDb","pan","muted"],"properties":{"gainDb":{"$ref":"#/$defs/animatableNumber"},"pan":{"$ref":"#/$defs/animatableNumber"},"muted":{"type":"boolean"},"solo":{"type":"boolean","default":false}}},"extensions":{"$ref":"#/$defs/extensions"}}},"trackMap":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/track"}},"baseItem":{"type":"object","required":["id","trackId","type","enabled","range","materialInstanceIds"],"properties":{"id":{"$ref":"#/$defs/entityId"},"trackId":{"$ref":"#/$defs/entityId"},"type":{"enum":["video","audio","image","text","caption","shape","generator","nested-sequence","adjustment","material-content"]},"name":{"type":"string","maxLength":256},"enabled":{"type":"boolean"},"range":{"$ref":"#/$defs/range"},"materialInstanceIds":{"$ref":"#/$defs/idList"},"linkGroupId":{"$ref":"#/$defs/entityId"},"markerIds":{"$ref":"#/$defs/idList"},"metadata":{"$ref":"#/$defs/jsonObject"},"extensions":{"$ref":"#/$defs/extensions"}}},"mediaSource":{"type":"object","additionalProperties":false,"required":["assetId","stream","sourceRange","timeMapping"],"properties":{"assetId":{"$ref":"#/$defs/entityId"},"stream":{"type":"object","additionalProperties":false,"required":["type","index"],"properties":{"type":{"enum":["video","audio"]},"index":{"type":"integer","minimum":0,"maximum":1024}}},"sourceRange":{"$ref":"#/$defs/range"},"timeMapping":{"oneOf":[{"type":"object","additionalProperties":false,"required":["type","rate","reverse","boundary"],"properties":{"type":{"const":"linear"},"rate":{"$ref":"#/$defs/rational"},"reverse":{"type":"boolean"},"boundary":{"enum":["error","hold","loop","transparent"]}}},{"type":"object","additionalProperties":false,"required":["type","points","boundary"],"properties":{"type":{"const":"curve"},"points":{"type":"array","minItems":2,"maxItems":4096,"items":{"type":"object","maxProperties":4096,"additionalProperties":true,"required":["itemTimeUs","sourceTimeUs","interpolation"],"properties":{"itemTimeUs":{"$ref":"#/$defs/timeUs"},"sourceTimeUs":{"$ref":"#/$defs/timeUs"},"interpolation":{"enum":["linear","hold","cubic"]}}}},"boundary":{"enum":["error","hold","loop","transparent"]}}}]}}},"visual":{"type":"object","additionalProperties":false,"required":["fit","transform","crop","opacity","blendMode"],"properties":{"fit":{"enum":["contain","cover","fill","none"]},"transform":{"type":"object","additionalProperties":false,"required":["positionPx","anchor","scale","rotationDeg","skewDeg"],"properties":{"positionPx":{"$ref":"#/$defs/animatableVec2"},"anchor":{"$ref":"#/$defs/animatableVec2"},"scale":{"$ref":"#/$defs/animatableVec2"},"rotationDeg":{"$ref":"#/$defs/animatableNumber"},"skewDeg":{"$ref":"#/$defs/animatableVec2"}}},"crop":{"oneOf":[{"type":"object","additionalProperties":false,"required":["left","top","right","bottom"],"properties":{"left":{"type":"number","minimum":0,"maximum":1},"top":{"type":"number","minimum":0,"maximum":1},"right":{"type":"number","minimum":0,"maximum":1},"bottom":{"type":"number","minimum":0,"maximum":1}}},{"$ref":"#/$defs/animation"}]},"opacity":{"$ref":"#/$defs/animatableNumber"},"blendMode":{"enum":["normal","multiply","screen","overlay","darken","lighten","color-dodge","color-burn","hard-light","soft-light","difference","exclusion"]},"mask":{"type":"object","additionalProperties":false,"required":["sourceItemId","channel","invert","featherPx","space","consumeSource"],"properties":{"sourceItemId":{"$ref":"#/$defs/entityId"},"channel":{"enum":["alpha","luma"]},"invert":{"type":"boolean"},"featherPx":{"type":"number","minimum":0,"maximum":4096},"space":{"enum":["source","canvas"]},"consumeSource":{"type":"boolean"}}}}},"audioProperties":{"type":"object","additionalProperties":false,"required":["gainDb","pan"],"properties":{"gainDb":{"$ref":"#/$defs/animatableNumber"},"pan":{"$ref":"#/$defs/animatableNumber"},"fadeInUs":{"$ref":"#/$defs/timeUs"},"fadeOutUs":{"$ref":"#/$defs/timeUs"},"pitchPolicy":{"enum":["varispeed","preserve"],"description":"Varispeed follows source time directly; preserve uses deterministic overlap-add time stretching."},"channelMap":{"type":"array","maxItems":16384,"items":{"type":"array","maxItems":16384,"items":{"type":"number"}}}}},"videoItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["source","visual"],"properties":{"type":{"const":"video"},"source":{"$ref":"#/$defs/mediaSource"},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"audioItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["source","audio"],"properties":{"type":{"const":"audio"},"source":{"$ref":"#/$defs/mediaSource"},"audio":{"$ref":"#/$defs/audioProperties"}}}],"unevaluatedProperties":false},"imageItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["source","visual"],"properties":{"type":{"const":"image"},"source":{"$ref":"#/$defs/mediaSource"},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"textItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["box","overflow","writingMode","paragraphs","visual"],"properties":{"type":{"const":"text"},"box":{"type":"object","additionalProperties":false,"required":["x","y","width","height"],"properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}}},"overflow":{"enum":["clip","ellipsis","visible","auto-fit"]},"writingMode":{"enum":["horizontal-tb","vertical-rl","vertical-lr"]},"paragraphs":{"type":"array","minItems":1,"maxItems":10000,"items":{"type":"object","additionalProperties":false,"required":["style","runs"],"properties":{"style":{"$ref":"#/$defs/jsonObject"},"runs":{"type":"array","minItems":1,"maxItems":10000,"items":{"type":"object","additionalProperties":false,"required":["text","style"],"properties":{"text":{"type":"string","maxLength":1000000},"style":{"$ref":"#/$defs/jsonObject"}}}}}}},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"captionItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["text","box","style","visual"],"properties":{"type":{"const":"caption"},"text":{"type":"string","maxLength":1000000},"box":{"type":"object","additionalProperties":false,"required":["x","y","width","height"],"properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}}},"style":{"$ref":"#/$defs/jsonObject"},"overflow":{"enum":["clip","auto-fit"]},"cueSettings":{"$ref":"#/$defs/jsonObject"},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"nestedSequenceItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["source","visual"],"properties":{"type":{"const":"nested-sequence"},"source":{"type":"object","additionalProperties":false,"required":["sequenceId","sourceRange","timeMapping"],"properties":{"sequenceId":{"$ref":"#/$defs/entityId"},"sourceRange":{"$ref":"#/$defs/range"},"timeMapping":{"$ref":"#/$defs/mediaSource/properties/timeMapping"}}},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"generatorItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["generator","visual"],"properties":{"type":{"const":"generator"},"generator":{"type":"object","additionalProperties":false,"required":["kind","colors"],"properties":{"kind":{"enum":["solid","linear-gradient"]},"colors":{"type":"array","minItems":1,"maxItems":16,"items":{"$ref":"#/$defs/color"}},"angleDeg":{"type":"number"}}},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"adjustmentItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["visual"],"properties":{"type":{"const":"adjustment"},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"shapeItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["shape","visual"],"properties":{"type":{"const":"shape"},"shape":{"type":"object","additionalProperties":false,"required":["kind","box","fill"],"properties":{"kind":{"enum":["rectangle","ellipse","polygon"]},"box":{"type":"object","additionalProperties":false,"required":["x","y","width","height"],"properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}}},"fill":{"$ref":"#/$defs/color"},"stroke":{"$ref":"#/$defs/color"},"strokeWidthPx":{"type":"number","minimum":0,"maximum":4096},"cornerRadiusPx":{"type":"number","minimum":0,"maximum":32768},"points":{"type":"array","minItems":3,"maxItems":1024,"items":{"$ref":"#/$defs/vec2"}}}},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"materialContentItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["materialInstanceId","visual"],"properties":{"type":{"const":"material-content"},"materialInstanceId":{"$ref":"#/$defs/entityId"},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"item":{"oneOf":[{"$ref":"#/$defs/videoItem"},{"$ref":"#/$defs/audioItem"},{"$ref":"#/$defs/imageItem"},{"$ref":"#/$defs/textItem"},{"$ref":"#/$defs/captionItem"},{"$ref":"#/$defs/nestedSequenceItem"},{"$ref":"#/$defs/generatorItem"},{"$ref":"#/$defs/adjustmentItem"},{"$ref":"#/$defs/materialContentItem"},{"$ref":"#/$defs/shapeItem"}]},"itemMap":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/item"}},"transition":{"type":"object","additionalProperties":false,"required":["id","sequenceId","trackId","kind","fromItemId","toItemId","range","materialInstanceId"],"properties":{"id":{"$ref":"#/$defs/entityId"},"sequenceId":{"$ref":"#/$defs/entityId"},"trackId":{"$ref":"#/$defs/entityId"},"kind":{"enum":["visual","audio"]},"fromItemId":{"$ref":"#/$defs/entityId"},"toItemId":{"$ref":"#/$defs/entityId"},"range":{"$ref":"#/$defs/range"},"materialInstanceId":{"$ref":"#/$defs/entityId"},"extensions":{"$ref":"#/$defs/extensions"}}},"transitionMap":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/transition"}},"marker":{"type":"object","additionalProperties":false,"required":["id","owner","timeUs","durationUs"],"properties":{"id":{"$ref":"#/$defs/entityId"},"owner":{"type":"object","additionalProperties":false,"required":["type","id"],"properties":{"type":{"enum":["sequence","item"]},"id":{"$ref":"#/$defs/entityId"}}},"timeUs":{"$ref":"#/$defs/timeUs"},"durationUs":{"$ref":"#/$defs/timeUs"},"label":{"type":"string","maxLength":1024},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}(?:[0-9a-fA-F]{2})?$"},"payload":{"$ref":"#/$defs/jsonValue"}}},"markerMap":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/marker"}},"linkGroup":{"type":"object","additionalProperties":false,"required":["id","kind","itemIds"],"properties":{"id":{"$ref":"#/$defs/entityId"},"kind":{"enum":["av-sync","edit-group"]},"itemIds":{"$ref":"#/$defs/idList"},"syncOffsetsUs":{"type":"object","maxProperties":4096,"additionalProperties":{"$ref":"#/$defs/safeInteger"}}}},"linkGroupMap":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/linkGroup"}}}}`);
+const projectSchema = JSON.parse(String.raw `{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://schemas.aelion.dev/project/v1.json","title":"Aelion Project Document v1","type":"object","additionalProperties":false,"required":["$schema","schemaVersion","projectId","metadata","settings","assets","sequences","tracks","items","materialInstances","transitions","markers","linkGroups","extensions"],"properties":{"$schema":{"const":"https://schemas.aelion.dev/project/v1.json"},"schemaVersion":{"const":"1.0.0"},"projectId":{"$ref":"#/$defs/entityId"},"metadata":{"$ref":"#/$defs/jsonObject"},"settings":{"$ref":"#/$defs/settings"},"assets":{"$ref":"#/$defs/assetMap"},"sequences":{"$ref":"#/$defs/sequenceMap"},"tracks":{"$ref":"#/$defs/trackMap"},"items":{"$ref":"#/$defs/itemMap"},"materialInstances":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"https://schemas.aelion.dev/material/instance/v1.json"}},"transitions":{"$ref":"#/$defs/transitionMap"},"markers":{"$ref":"#/$defs/markerMap"},"linkGroups":{"$ref":"#/$defs/linkGroupMap"},"extensions":{"$ref":"#/$defs/extensions"}},"$defs":{"entityId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z][A-Za-z0-9._:-]*$"},"safeInteger":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"timeUs":{"type":"integer","minimum":0,"maximum":9007199254740991},"positiveDurationUs":{"type":"integer","minimum":1,"maximum":9007199254740991},"jsonValue":{"oneOf":[{"type":"null"},{"type":"boolean"},{"type":"number"},{"type":"string"},{"type":"array","maxItems":16384,"items":{"$ref":"#/$defs/jsonValue"}},{"type":"object","maxProperties":4096,"additionalProperties":{"$ref":"#/$defs/jsonValue"}}]},"jsonObject":{"type":"object","maxProperties":4096,"additionalProperties":{"$ref":"#/$defs/jsonValue"}},"extensions":{"type":"object","maxProperties":4096,"propertyNames":{"type":"string","pattern":"^[a-z0-9]+(?:\\.[a-z0-9-]+)+$"},"additionalProperties":{"$ref":"#/$defs/jsonValue"}},"rational":{"type":"object","additionalProperties":false,"required":["numerator","denominator"],"properties":{"numerator":{"type":"integer","minimum":1,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":1,"maximum":9007199254740991}}},"range":{"type":"object","additionalProperties":false,"required":["startUs","durationUs"],"properties":{"startUs":{"$ref":"#/$defs/timeUs"},"durationUs":{"$ref":"#/$defs/positiveDurationUs"}}},"color":{"type":"object","additionalProperties":false,"required":["space","rgba"],"properties":{"space":{"enum":["srgb-linear","display-p3-linear","rec2020-linear"]},"rgba":{"type":"array","minItems":4,"maxItems":4,"items":{"type":"number"}}}},"vec2":{"type":"object","additionalProperties":false,"required":["x","y"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"animation":{"type":"object","additionalProperties":false,"required":["animation"],"properties":{"animation":{"type":"object","additionalProperties":false,"required":["timeSpace","preInfinity","postInfinity","keyframes"],"properties":{"timeSpace":{"enum":["item","sequence"]},"preInfinity":{"enum":["hold","linear","none","cycle","ping-pong"]},"postInfinity":{"enum":["hold","linear","none","cycle","ping-pong"]},"keyframes":{"type":"array","minItems":1,"maxItems":4096,"items":{"type":"object","additionalProperties":false,"required":["timeUs","value","interpolation"],"properties":{"timeUs":{"$ref":"#/$defs/timeUs"},"value":{"$ref":"#/$defs/jsonValue"},"interpolation":{"enum":["hold","linear","cubic-bezier"]},"easing":{"type":"object","required":["type"],"properties":{"type":{"enum":["linear","steps","cubic-bezier"]},"count":{"type":"integer","minimum":1},"position":{"enum":["start","end"]},"x1":{"type":"number"},"y1":{"type":"number"},"x2":{"type":"number"},"y2":{"type":"number"}},"additionalProperties":false}}}}}}}},"animatableNumber":{"oneOf":[{"type":"number"},{"$ref":"#/$defs/animation"}]},"animatableVec2":{"oneOf":[{"$ref":"#/$defs/vec2"},{"$ref":"#/$defs/animation"}]},"settings":{"type":"object","additionalProperties":false,"required":["defaultSequenceId","defaultStillDurationUs","missingAssetPolicy","missingMaterialPolicy","missingPluginPolicy"],"properties":{"defaultSequenceId":{"$ref":"#/$defs/entityId"},"defaultStillDurationUs":{"$ref":"#/$defs/positiveDurationUs"},"locale":{"type":"string","minLength":1,"maxLength":128},"timezone":{"type":"string","minLength":1,"maxLength":128},"missingAssetPolicy":{"enum":["placeholder","error"]},"missingMaterialPolicy":{"enum":["placeholder","error"]},"missingPluginPolicy":{"enum":["placeholder","error"]}}},"assetLocator":{"oneOf":[{"type":"object","additionalProperties":false,"required":["type","uri"],"properties":{"type":{"const":"url"},"uri":{"type":"string","minLength":1,"maxLength":8192}}},{"type":"object","additionalProperties":false,"required":["type","bindingId"],"properties":{"type":{"const":"runtime-binding"},"bindingId":{"$ref":"#/$defs/entityId"}}},{"type":"object","additionalProperties":false,"required":["type","path"],"properties":{"type":{"const":"opfs"},"path":{"type":"string","minLength":1,"maxLength":4096}}},{"type":"object","additionalProperties":false,"required":["type","mimeType","base64"],"properties":{"type":{"const":"data"},"mimeType":{"type":"string","minLength":1,"maxLength":256},"base64":{"type":"string","maxLength":349528}}}]},"asset":{"type":"object","additionalProperties":false,"required":["id","kind","locator"],"properties":{"id":{"$ref":"#/$defs/entityId"},"kind":{"enum":["video","audio","image","font","lut","binary"]},"name":{"type":"string","maxLength":256},"locator":{"$ref":"#/$defs/assetLocator"},"contentHash":{"type":"object","additionalProperties":false,"required":["algorithm","value"],"properties":{"algorithm":{"const":"sha256"},"value":{"type":"string","pattern":"^[0-9a-f]{64}$"}}},"byteLength":{"type":"integer","minimum":0,"maximum":9007199254740991},"mimeType":{"type":"string","minLength":1,"maxLength":256},"representations":{"type":"array","maxItems":32,"items":{"type":"object","maxProperties":4096,"additionalProperties":true,"required":["id","role","locator"],"properties":{"id":{"$ref":"#/$defs/entityId"},"role":{"enum":["original","proxy","thumbnail","waveform"]},"locator":{"$ref":"#/$defs/assetLocator"}}}},"probeHint":{"type":"object","additionalProperties":false,"properties":{"durationUs":{"$ref":"#/$defs/positiveDurationUs"},"width":{"type":"integer","minimum":1,"maximum":65535},"height":{"type":"integer","minimum":1,"maximum":65535},"videoCodec":{"type":"string","maxLength":256},"audioCodec":{"type":"string","maxLength":256}}},"metadata":{"$ref":"#/$defs/jsonObject"},"extensions":{"$ref":"#/$defs/extensions"}}},"assetMap":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/asset"}},"sequence":{"type":"object","additionalProperties":false,"required":["id","format","duration","trackIds","transitionIds","materialInstanceIds","markerIds"],"properties":{"id":{"$ref":"#/$defs/entityId"},"name":{"type":"string","maxLength":256},"format":{"type":"object","additionalProperties":false,"required":["width","height","pixelAspectRatio","frameRate","sampleRate","channelLayout","workingColorSpace","backgroundColor"],"properties":{"width":{"type":"integer","minimum":1,"maximum":65535},"height":{"type":"integer","minimum":1,"maximum":65535},"pixelAspectRatio":{"$ref":"#/$defs/rational"},"frameRate":{"$ref":"#/$defs/rational"},"sampleRate":{"enum":[44100,48000,96000]},"channelLayout":{"enum":["mono","stereo","5.1"]},"workingColorSpace":{"enum":["srgb-linear","display-p3-linear","rec2020-linear"]},"transferFunction":{"enum":["srgb","gamma22","pq","hlg"],"default":"srgb"},"colorPrimaries":{"enum":["bt709","display-p3","bt2020"],"default":"bt709"},"matrixCoefficients":{"enum":["rgb","bt709","bt2020-ncl"],"default":"rgb"},"colorRange":{"enum":["full","limited"],"default":"full"},"chromaSubsampling":{"enum":["rgb","4:4:4","4:2:2","4:2:0"],"default":"4:4:4"},"alphaMode":{"enum":["opaque","premultiplied"],"default":"premultiplied"},"toneMapping":{"enum":["none","bt2390","reinhard"],"default":"none"},"bitDepth":{"enum":[8,10],"default":8},"backgroundColor":{"$ref":"#/$defs/color"}}},"duration":{"oneOf":[{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"const":"content"}}},{"type":"object","additionalProperties":false,"required":["mode","durationUs","overflow"],"properties":{"mode":{"const":"fixed"},"durationUs":{"$ref":"#/$defs/timeUs"},"overflow":{"enum":["clip","allow"]}}}]},"trackIds":{"$ref":"#/$defs/idList"},"transitionIds":{"$ref":"#/$defs/idList"},"materialInstanceIds":{"$ref":"#/$defs/idList"},"markerIds":{"$ref":"#/$defs/idList"},"extensions":{"$ref":"#/$defs/extensions"}}},"sequenceMap":{"type":"object","minProperties":1,"maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/sequence"}},"idList":{"type":"array","maxItems":16384,"items":{"$ref":"#/$defs/entityId"}},"track":{"type":"object","additionalProperties":false,"required":["id","sequenceId","kind","enabled","locked","itemIds","materialInstanceIds"],"properties":{"id":{"$ref":"#/$defs/entityId"},"sequenceId":{"$ref":"#/$defs/entityId"},"kind":{"enum":["visual","audio","caption"]},"name":{"type":"string","maxLength":256},"enabled":{"type":"boolean"},"locked":{"type":"boolean"},"itemIds":{"$ref":"#/$defs/idList"},"materialInstanceIds":{"$ref":"#/$defs/idList"},"audio":{"type":"object","additionalProperties":false,"required":["gainDb","pan","muted"],"properties":{"gainDb":{"$ref":"#/$defs/animatableNumber"},"pan":{"$ref":"#/$defs/animatableNumber"},"muted":{"type":"boolean"},"solo":{"type":"boolean","default":false}}},"extensions":{"$ref":"#/$defs/extensions"}}},"trackMap":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/track"}},"baseItem":{"type":"object","required":["id","trackId","type","enabled","range","materialInstanceIds"],"properties":{"id":{"$ref":"#/$defs/entityId"},"trackId":{"$ref":"#/$defs/entityId"},"type":{"enum":["video","audio","image","text","caption","shape","generator","nested-sequence","adjustment","material-content"]},"name":{"type":"string","maxLength":256},"enabled":{"type":"boolean"},"range":{"$ref":"#/$defs/range"},"materialInstanceIds":{"$ref":"#/$defs/idList"},"linkGroupId":{"$ref":"#/$defs/entityId"},"markerIds":{"$ref":"#/$defs/idList"},"metadata":{"$ref":"#/$defs/jsonObject"},"extensions":{"$ref":"#/$defs/extensions"}}},"mediaSource":{"type":"object","additionalProperties":false,"required":["assetId","stream","sourceRange","timeMapping"],"properties":{"assetId":{"$ref":"#/$defs/entityId"},"stream":{"type":"object","additionalProperties":false,"required":["type","index"],"properties":{"type":{"enum":["video","audio"]},"index":{"type":"integer","minimum":0,"maximum":1024}}},"sourceRange":{"$ref":"#/$defs/range"},"timeMapping":{"oneOf":[{"type":"object","additionalProperties":false,"required":["type","rate","reverse","boundary"],"properties":{"type":{"const":"linear"},"rate":{"$ref":"#/$defs/rational"},"reverse":{"type":"boolean"},"boundary":{"enum":["error","hold","loop","transparent"]}}},{"type":"object","additionalProperties":false,"required":["type","points","boundary"],"properties":{"type":{"const":"curve"},"points":{"type":"array","minItems":2,"maxItems":4096,"items":{"type":"object","maxProperties":4096,"additionalProperties":true,"required":["itemTimeUs","sourceTimeUs","interpolation"],"properties":{"itemTimeUs":{"$ref":"#/$defs/timeUs"},"sourceTimeUs":{"$ref":"#/$defs/timeUs"},"interpolation":{"enum":["linear","hold","cubic"]}}}},"boundary":{"enum":["error","hold","loop","transparent"]}}}]}}},"visual":{"type":"object","additionalProperties":false,"required":["fit","transform","crop","opacity","blendMode"],"properties":{"fit":{"enum":["contain","cover","fill","none"]},"transform":{"type":"object","additionalProperties":false,"required":["positionPx","anchor","scale","rotationDeg","skewDeg"],"properties":{"positionPx":{"$ref":"#/$defs/animatableVec2"},"anchor":{"$ref":"#/$defs/animatableVec2"},"scale":{"$ref":"#/$defs/animatableVec2"},"rotationDeg":{"$ref":"#/$defs/animatableNumber"},"skewDeg":{"$ref":"#/$defs/animatableVec2"}}},"crop":{"oneOf":[{"type":"object","additionalProperties":false,"required":["left","top","right","bottom"],"properties":{"left":{"type":"number","minimum":0,"maximum":1},"top":{"type":"number","minimum":0,"maximum":1},"right":{"type":"number","minimum":0,"maximum":1},"bottom":{"type":"number","minimum":0,"maximum":1}}},{"$ref":"#/$defs/animation"}]},"opacity":{"$ref":"#/$defs/animatableNumber"},"blendMode":{"enum":["normal","multiply","screen","overlay","darken","lighten","color-dodge","color-burn","hard-light","soft-light","difference","exclusion"]},"mask":{"type":"object","additionalProperties":false,"required":["sourceItemId","channel","invert","featherPx","space","consumeSource"],"properties":{"sourceItemId":{"$ref":"#/$defs/entityId"},"channel":{"enum":["alpha","luma"]},"invert":{"type":"boolean"},"featherPx":{"type":"number","minimum":0,"maximum":4096},"space":{"enum":["source","canvas"]},"consumeSource":{"type":"boolean"}}}}},"audioProperties":{"type":"object","additionalProperties":false,"required":["gainDb","pan"],"properties":{"gainDb":{"$ref":"#/$defs/animatableNumber"},"pan":{"$ref":"#/$defs/animatableNumber"},"fadeInUs":{"$ref":"#/$defs/timeUs"},"fadeOutUs":{"$ref":"#/$defs/timeUs"},"pitchPolicy":{"enum":["varispeed","preserve"],"description":"Varispeed follows source time directly; preserve uses deterministic overlap-add time stretching."},"channelMap":{"type":"array","maxItems":16384,"items":{"type":"array","maxItems":16384,"items":{"type":"number"}}}}},"videoItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["source","visual"],"properties":{"type":{"const":"video"},"source":{"$ref":"#/$defs/mediaSource"},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"audioItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["source","audio"],"properties":{"type":{"const":"audio"},"source":{"$ref":"#/$defs/mediaSource"},"audio":{"$ref":"#/$defs/audioProperties"}}}],"unevaluatedProperties":false},"imageItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["source","visual"],"properties":{"type":{"const":"image"},"source":{"$ref":"#/$defs/mediaSource"},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"textItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["box","overflow","writingMode","paragraphs","visual"],"properties":{"type":{"const":"text"},"box":{"type":"object","additionalProperties":false,"required":["x","y","width","height"],"properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}}},"overflow":{"enum":["clip","ellipsis","visible","auto-fit"]},"writingMode":{"enum":["horizontal-tb","vertical-rl","vertical-lr"]},"paragraphs":{"type":"array","minItems":1,"maxItems":10000,"items":{"type":"object","additionalProperties":false,"required":["style","runs"],"properties":{"style":{"$ref":"#/$defs/jsonObject"},"runs":{"type":"array","minItems":1,"maxItems":10000,"items":{"type":"object","additionalProperties":false,"required":["text","style"],"properties":{"text":{"type":"string","maxLength":1000000},"style":{"$ref":"#/$defs/jsonObject"}}}}}}},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"captionItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["text","box","style","visual"],"properties":{"type":{"const":"caption"},"text":{"type":"string","maxLength":1000000},"box":{"type":"object","additionalProperties":false,"required":["x","y","width","height"],"properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}}},"style":{"$ref":"#/$defs/jsonObject"},"overflow":{"enum":["clip","auto-fit"]},"cueSettings":{"$ref":"#/$defs/jsonObject"},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"nestedSequenceItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["source","visual"],"properties":{"type":{"const":"nested-sequence"},"source":{"type":"object","additionalProperties":false,"required":["sequenceId","sourceRange","timeMapping"],"properties":{"sequenceId":{"$ref":"#/$defs/entityId"},"sourceRange":{"$ref":"#/$defs/range"},"timeMapping":{"$ref":"#/$defs/mediaSource/properties/timeMapping"}}},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"generatorItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["generator","visual"],"properties":{"type":{"const":"generator"},"generator":{"type":"object","additionalProperties":false,"required":["kind","colors"],"properties":{"kind":{"enum":["solid","linear-gradient"]},"colors":{"type":"array","minItems":1,"maxItems":16,"items":{"$ref":"#/$defs/color"}},"angleDeg":{"type":"number"}}},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"adjustmentItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["visual"],"properties":{"type":{"const":"adjustment"},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"shapeItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["shape","visual"],"properties":{"type":{"const":"shape"},"shape":{"type":"object","additionalProperties":false,"required":["kind","box","fill"],"properties":{"kind":{"enum":["rectangle","ellipse","polygon"]},"box":{"type":"object","additionalProperties":false,"required":["x","y","width","height"],"properties":{"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}}},"fill":{"$ref":"#/$defs/color"},"stroke":{"$ref":"#/$defs/color"},"strokeWidthPx":{"type":"number","minimum":0,"maximum":4096},"cornerRadiusPx":{"type":"number","minimum":0,"maximum":32768},"points":{"type":"array","minItems":3,"maxItems":1024,"items":{"$ref":"#/$defs/vec2"}}}},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"materialContentItem":{"type":"object","allOf":[{"$ref":"#/$defs/baseItem"},{"type":"object","required":["materialInstanceId","visual"],"properties":{"type":{"const":"material-content"},"materialInstanceId":{"$ref":"#/$defs/entityId"},"visual":{"$ref":"#/$defs/visual"}}}],"unevaluatedProperties":false},"item":{"oneOf":[{"$ref":"#/$defs/videoItem"},{"$ref":"#/$defs/audioItem"},{"$ref":"#/$defs/imageItem"},{"$ref":"#/$defs/textItem"},{"$ref":"#/$defs/captionItem"},{"$ref":"#/$defs/nestedSequenceItem"},{"$ref":"#/$defs/generatorItem"},{"$ref":"#/$defs/adjustmentItem"},{"$ref":"#/$defs/materialContentItem"},{"$ref":"#/$defs/shapeItem"}]},"itemMap":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/item"}},"transition":{"type":"object","additionalProperties":false,"required":["id","sequenceId","trackId","kind","fromItemId","toItemId","range","materialInstanceId"],"properties":{"id":{"$ref":"#/$defs/entityId"},"sequenceId":{"$ref":"#/$defs/entityId"},"trackId":{"$ref":"#/$defs/entityId"},"kind":{"enum":["visual","audio"]},"fromItemId":{"$ref":"#/$defs/entityId"},"toItemId":{"$ref":"#/$defs/entityId"},"range":{"$ref":"#/$defs/range"},"materialInstanceId":{"$ref":"#/$defs/entityId"},"extensions":{"$ref":"#/$defs/extensions"}}},"transitionMap":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/transition"}},"marker":{"type":"object","additionalProperties":false,"required":["id","owner","timeUs","durationUs"],"properties":{"id":{"$ref":"#/$defs/entityId"},"owner":{"type":"object","additionalProperties":false,"required":["type","id"],"properties":{"type":{"enum":["sequence","item"]},"id":{"$ref":"#/$defs/entityId"}}},"timeUs":{"$ref":"#/$defs/timeUs"},"durationUs":{"$ref":"#/$defs/timeUs"},"label":{"type":"string","maxLength":1024},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}(?:[0-9a-fA-F]{2})?$"},"payload":{"$ref":"#/$defs/jsonValue"}}},"markerMap":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/marker"}},"linkGroup":{"type":"object","additionalProperties":false,"required":["id","kind","itemIds"],"properties":{"id":{"$ref":"#/$defs/entityId"},"kind":{"enum":["av-sync","edit-group"]},"itemIds":{"$ref":"#/$defs/idList"},"syncOffsetsUs":{"type":"object","maxProperties":4096,"additionalProperties":{"$ref":"#/$defs/safeInteger"}}}},"linkGroupMap":{"type":"object","maxProperties":4096,"propertyNames":{"$ref":"#/$defs/entityId"},"additionalProperties":{"$ref":"#/$defs/linkGroup"}}}}`);
 const materialInstanceSchema = JSON.parse(String.raw `{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://schemas.aelion.dev/material/instance/v1.json","title":"Aelion Project Material Instance v1","type":"object","additionalProperties":false,"required":["id","definition","enabled","parameters"],"properties":{"id":{"type":"string","minLength":1,"maxLength":128},"definition":{"type":"object","additionalProperties":false,"required":["packageId","packageVersion","packageIntegrity","materialId"],"properties":{"packageId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9]+(?:[._-][a-z0-9]+)*$"},"packageVersion":{"type":"string","pattern":"^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$"},"packageIntegrity":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"materialId":{"type":"string","minLength":1,"maxLength":96,"pattern":"^[A-Za-z][A-Za-z0-9_-]*$"}}},"name":{"type":"string","maxLength":256},"enabled":{"type":"boolean"},"previewPolicy":{"enum":["required","skippable-when-degraded"]},"parameters":{"type":"object","maxProperties":64,"additionalProperties":true},"resourceBindings":{"type":"object","maxProperties":16,"additionalProperties":true},"inputBindings":{"type":"object","maxProperties":16,"additionalProperties":true},"randomSeed":{"type":"integer","minimum":0,"maximum":4294967295},"extensions":{"type":"object","additionalProperties":true}}}`);
 /**
  * The canonical v1 validators bundled into the JavaScript artifact. Consumers

package/dist/diagnostic-report.d.ts

@@ -0,0 +1,13 @@
+import type { CapabilityReport } from '@aelionsdk/capability';
+import type { Diagnostic, JsonObject } from '@aelionsdk/core';
+import type { AelionDiagnosticReport, AelionDiagnosticReportOptions, AelionSessionState, AelionSessionStats } from './types.js';
+export declare function createAelionDiagnosticReport(input: {
+    readonly state: AelionSessionState;
+    readonly revision: bigint | null;
+    readonly capability: CapabilityReport | null;
+    readonly diagnostics: readonly Diagnostic[];
+    readonly stats: AelionSessionStats;
+    readonly media: JsonObject | null;
+    readonly options?: AelionDiagnosticReportOptions;
+}): AelionDiagnosticReport;
+//# sourceMappingURL=diagnostic-report.d.ts.map

package/dist/diagnostic-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-report.d.ts","sourceRoot":"","sources":["../src/diagnostic-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAa,MAAM,iBAAiB,CAAC;AAEzE,OAAO,KAAK,EACV,sBAAsB,EACtB,6BAA6B,EAC7B,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAwFpB,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,6BAA6B,CAAC;CAClD,GAAG,sBAAsB,CAgBzB"}

package/dist/diagnostic-report.js

@@ -0,0 +1,107 @@
+function jsonValue(value) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : null;
+    if (typeof value === 'bigint')
+        return value.toString();
+    if (Array.isArray(value))
+        return value.map(jsonValue);
+    if (typeof value === 'object') {
+        const result = {};
+        for (const [key, member] of Object.entries(value)) {
+            if (member === undefined || typeof member === 'function' || typeof member === 'symbol') {
+                continue;
+            }
+            result[key] = jsonValue(member);
+        }
+        return result;
+    }
+    if (typeof value === 'symbol')
+        return value.description ?? '';
+    if (typeof value === 'function')
+        return `[function ${value.name || 'anonymous'}]`;
+    return null;
+}
+function safeDiagnostic(value, full) {
+    return {
+        code: value.code,
+        severity: value.severity,
+        recoverable: value.recoverable,
+        ...(value.path === undefined ? {} : { path: jsonValue(value.path) }),
+        ...(value.rangeUs === undefined ? {} : { rangeUs: jsonValue(value.rangeUs) }),
+        ...(full
+            ? {
+                message: value.message,
+                ...(value.entityId === undefined ? {} : { entityId: value.entityId }),
+                ...(value.details === undefined ? {} : { details: jsonValue(value.details) }),
+            }
+            : {}),
+    };
+}
+function safeProbe(value) {
+    return {
+        status: value.status,
+        available: value.available,
+    };
+}
+function capability(value, full) {
+    if (value === null)
+        return null;
+    if (full)
+        return jsonValue(value);
+    return jsonValue({
+        schemaVersion: value.schemaVersion,
+        generatedAt: value.generatedAt,
+        tier: value.tier,
+        codecs: value.codecs.map(codec => ({
+            id: codec.id,
+            kind: codec.kind,
+            codec: codec.codec,
+            supported: codec.supported,
+        })),
+        gpu: {
+            webgpu: safeProbe(value.gpu.webgpu),
+            webgl2: safeProbe(value.gpu.webgl2),
+            offscreenCanvas: safeProbe(value.gpu.offscreenCanvas),
+            worker: safeProbe(value.gpu.worker),
+        },
+        audio: {
+            audioContext: safeProbe(value.audio.audioContext),
+            audioWorklet: safeProbe(value.audio.audioWorklet),
+            sharedArrayBuffer: safeProbe(value.audio.sharedArrayBuffer),
+        },
+        storage: {
+            opfs: safeProbe(value.storage.opfs),
+            fileSystemAccess: safeProbe(value.storage.fileSystemAccess),
+            transferableStreams: safeProbe(value.storage.transferableStreams),
+        },
+        color: {
+            displayP3Gamut: safeProbe(value.color.displayP3Gamut),
+            highDynamicRange: safeProbe(value.color.highDynamicRange),
+            localExecution: value.color.localExecution,
+        },
+        wasm: { available: safeProbe(value.wasm.available) },
+        environment: {
+            secureContext: value.environment.secureContext,
+            crossOriginIsolated: value.environment.crossOriginIsolated,
+        },
+    });
+}
+export function createAelionDiagnosticReport(input) {
+    const privacy = input.options?.privacy ?? 'safe';
+    const full = privacy === 'full';
+    return Object.freeze({
+        schemaVersion: '1.0.0',
+        generatedAt: new Date().toISOString(),
+        privacy,
+        session: Object.freeze({
+            state: input.state,
+            revision: input.revision?.toString() ?? null,
+        }),
+        capability: capability(input.capability, full),
+        diagnostics: Object.freeze(input.diagnostics.map(value => safeDiagnostic(value, full))),
+        stats: jsonValue(input.stats),
+        media: input.media === null ? null : jsonValue(input.media),
+    });
+}

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './media-provider.js';
 export * from './production-media-provider.js';
 export * from './project-builder.js';
 export * from './composition.js';
+export * from './diagnostic-report.js';
 export * from './migration.js';
 export * from './migration-materials.js';
 export * from './audio-controller.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAE3B,eAAO,MAAM,MAAM,EAAE,SAEpB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAE3B,eAAO,MAAM,MAAM,EAAE,SAEpB,CAAC"}

package/dist/index.js

@@ -4,6 +4,7 @@ export * from './media-provider.js';
 export * from './production-media-provider.js';
 export * from './project-builder.js';
 export * from './composition.js';
+export * from './diagnostic-report.js';
 export * from './migration.js';
 export * from './migration-materials.js';
 export * from './audio-controller.js';

package/dist/media-provider.d.ts

@@ -1,4 +1,5 @@
 import type { PcmSourceBlock } from '@aelionsdk/audio';
+import { type JsonObject } from '@aelionsdk/core';
 import type { AelionMediaProvider } from './types.js';
 export type AelionAssetBytesResolver = (assetId: string, signal?: AbortSignal) => Promise<Uint8Array>;
 export interface ByteMediaProviderOptions {
@@ -45,5 +46,6 @@ export declare class ByteMediaProvider implements AelionMediaProvider {
         /** Compatibility alias for maxConcurrentOperations. */
         readonly maxConcurrentLoads: number;
     };
+    getDiagnosticSnapshot(): JsonObject;
 }
 //# sourceMappingURL=media-provider.d.ts.map

package/dist/media-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-provider.d.ts","sourceRoot":"","sources":["../src/media-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAWvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,2FAA2F;IAC3F,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAgID;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;;gBAgBxC,OAAO,EAAE,wBAAwB;IA2BvC,OAAO,CAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IA+BT,QAAQ,CACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC;IAiBnB,KAAK,IAAI,IAAI;IAOb,QAAQ,IAAI;QACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;QACvC,oFAAoF;QACpF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,mFAAmF;QACnF,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;QACrC,8EAA8E;QAC9E,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;QAC5C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;QACzC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;QACtC,gDAAgD;QAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,iDAAiD;QACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,uDAAuD;QACvD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;KACrC;CA4NF"}
+{"version":3,"file":"media-provider.d.ts","sourceRoot":"","sources":["../src/media-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAU/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,2FAA2F;IAC3F,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAgID;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;;gBAgBxC,OAAO,EAAE,wBAAwB;IA2BvC,OAAO,CAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IA+BT,QAAQ,CACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC;IAiBnB,KAAK,IAAI,IAAI;IAOb,QAAQ,IAAI;QACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;QACvC,oFAAoF;QACpF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,mFAAmF;QACnF,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;QACrC,8EAA8E;QAC9E,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;QAC5C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;QACzC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;QACtC,gDAAgD;QAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,iDAAiD;QACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,uDAAuD;QACvD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;KACrC;IAuBM,qBAAqB,IAAI,UAAU;CAyM3C"}

package/dist/media-provider.js

@@ -190,6 +190,9 @@ export class ByteMediaProvider {
             maxConcurrentLoads: this.#maxConcurrentOperations,
         };
     }
+    getDiagnosticSnapshot() {
+        return this.snapshot();
+    }
     async #asset(assetId, signal) {
         if (signal?.aborted === true)
             throw abortReason(signal);

package/dist/migrate-cli-lib.d.ts

@@ -0,0 +1,39 @@
+import { type MigrationDiagnostic } from './migration.js';
+export type MigrationSource = 'webav' | 'diffusion';
+export interface MigrateProjectFileOptions {
+    readonly source: MigrationSource;
+    readonly inputPath: string;
+    readonly assetsPath?: string;
+    readonly outputPath?: string;
+    readonly reportPath?: string;
+    /** Reject migrations with unsupported rendering semantics. Defaults to true. */
+    readonly strict?: boolean;
+    /** Generate and validate the project without writing it. */
+    readonly dryRun?: boolean;
+}
+export interface ProjectMigrationFileReport {
+    readonly reportVersion: '1.0.0';
+    readonly source: MigrationSource;
+    readonly inputPath: string;
+    readonly assetsPath?: string;
+    readonly outputPath?: string;
+    readonly reportPath: string;
+    readonly strict: boolean;
+    readonly dryRun: boolean;
+    readonly status: 'passed' | 'lossy' | 'failed';
+    readonly projectId: string;
+    readonly projectBytes: number;
+    readonly projectSha256: string;
+    readonly diagnosticSummary: Readonly<Record<'info' | 'warning' | 'error', number>>;
+    readonly diagnostics: readonly MigrationDiagnostic[];
+    readonly entityMap: Readonly<Record<string, string>>;
+}
+/**
+ * Migrates a serialized WebAV snapshot or Diffusion Studio Core checkpoint.
+ *
+ * The report is always written before returning. Strict failures never write a
+ * project file, while `strict: false` makes an explicitly lossy project
+ * available together with the full loss report.
+ */
+export declare function migrateProjectFile(options: MigrateProjectFileOptions): Promise<ProjectMigrationFileReport>;
+//# sourceMappingURL=migrate-cli-lib.d.ts.map

package/dist/migrate-cli-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-cli-lib.d.ts","sourceRoot":"","sources":["../src/migrate-cli-lib.ts"],"names":[],"mappings":"AAMA,OAAO,EAIL,KAAK,mBAAmB,EAIzB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,WAAW,CAAC;AAEpD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACnF,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD;AA2ED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,0BAA0B,CAAC,CA+CrC"}

package/dist/migrate-cli-lib.js

@@ -0,0 +1,119 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { basename, dirname, extname, resolve } from 'node:path';
+import { migrateDiffusionCheckpoint, migrateWebAvProject, } from './migration.js';
+function parseJson(source, path) {
+    try {
+        return JSON.parse(source);
+    }
+    catch (error) {
+        throw new TypeError(`${path} is not valid JSON`, { cause: error });
+    }
+}
+function object(value, path) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new TypeError(`${path} must contain a JSON object`);
+    }
+    return value;
+}
+function array(value, path) {
+    if (!Array.isArray(value))
+        throw new TypeError(`${path} must contain a JSON array`);
+    return value;
+}
+async function readJson(path) {
+    return parseJson(await readFile(path, 'utf8'), path);
+}
+async function atomicWrite(path, data) {
+    const absolute = resolve(path);
+    await mkdir(dirname(absolute), { recursive: true });
+    const temporary = `${absolute}.${process.pid.toString()}.${randomUUID()}.tmp`;
+    await writeFile(temporary, data, 'utf8');
+    await rename(temporary, absolute);
+}
+function defaultOutputPath(inputPath) {
+    const absolute = resolve(inputPath);
+    const extension = extname(absolute);
+    const stem = basename(absolute, extension);
+    return resolve(dirname(absolute), `${stem}.aelion.json`);
+}
+function defaultReportPath(inputPath) {
+    const absolute = resolve(inputPath);
+    const extension = extname(absolute);
+    const stem = basename(absolute, extension);
+    return resolve(dirname(absolute), `${stem}.migration-report.json`);
+}
+function assetArray(value, path) {
+    if (Array.isArray(value))
+        return array(value, path);
+    const container = object(value, path);
+    return array(container.assets, `${path}.assets`);
+}
+function migrate(source, input, assets) {
+    if (source === 'webav') {
+        const snapshot = object(input, 'input');
+        const withAssets = assets === undefined
+            ? snapshot
+            : {
+                ...snapshot,
+                assets: assetArray(assets, 'assets'),
+            };
+        return migrateWebAvProject(withAssets, { strict: false });
+    }
+    return migrateDiffusionCheckpoint(input, {
+        strict: false,
+        assets: assets === undefined
+            ? []
+            : assetArray(assets, 'assets'),
+    });
+}
+/**
+ * Migrates a serialized WebAV snapshot or Diffusion Studio Core checkpoint.
+ *
+ * The report is always written before returning. Strict failures never write a
+ * project file, while `strict: false` makes an explicitly lossy project
+ * available together with the full loss report.
+ */
+export async function migrateProjectFile(options) {
+    const inputPath = resolve(options.inputPath);
+    const assetsPath = options.assetsPath === undefined ? undefined : resolve(options.assetsPath);
+    const outputPath = options.outputPath === undefined ? defaultOutputPath(inputPath) : resolve(options.outputPath);
+    const reportPath = options.reportPath === undefined ? defaultReportPath(inputPath) : resolve(options.reportPath);
+    const strict = options.strict ?? true;
+    const dryRun = options.dryRun ?? false;
+    const [input, assets] = await Promise.all([
+        readJson(inputPath),
+        assetsPath === undefined ? Promise.resolve(undefined) : readJson(assetsPath),
+    ]);
+    const result = migrate(options.source, input, assets);
+    const projectSource = `${JSON.stringify(result.project, null, 2)}\n`;
+    const projectBytes = Buffer.byteLength(projectSource);
+    const projectSha256 = createHash('sha256').update(projectSource).digest('hex');
+    const diagnosticSummary = result.diagnostics.reduce((summary, diagnostic) => {
+        summary[diagnostic.severity] += 1;
+        return summary;
+    }, { info: 0, warning: 0, error: 0 });
+    const hasErrors = diagnosticSummary.error > 0;
+    const status = hasErrors ? (strict ? 'failed' : 'lossy') : 'passed';
+    if (!dryRun && status !== 'failed')
+        await atomicWrite(outputPath, projectSource);
+    const report = {
+        reportVersion: '1.0.0',
+        source: options.source,
+        inputPath,
+        ...(assetsPath === undefined ? {} : { assetsPath }),
+        ...(!dryRun && status !== 'failed' ? { outputPath } : {}),
+        reportPath,
+        strict,
+        dryRun,
+        status,
+        projectId: result.project.projectId,
+        projectBytes,
+        projectSha256,
+        diagnosticSummary,
+        diagnostics: result.diagnostics,
+        entityMap: result.entityMap,
+    };
+    await atomicWrite(reportPath, `${JSON.stringify(report, null, 2)}\n`);
+    return report;
+}

package/dist/migrate-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=migrate-cli.d.ts.map

package/dist/migrate-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-cli.d.ts","sourceRoot":"","sources":["../src/migrate-cli.ts"],"names":[],"mappings":""}