Skip to content

The VS Code of video editing, built for agents.

TypeScript

Add @diffusionstudio/runtime package to package-lock.json

konstantin-paulus316505bfb879
diff --git a/package-lock.json b/package-lock.json
index dad5e407..2a52f5c4 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -597,6 +597,10 @@
"resolved": "packages/koota-solid",
"link": true
},
+ "node_modules/@diffusionstudio/runtime": {
+ "resolved": "packages/runtime",
+ "link": true
+ },
"node_modules/@diffusionstudio/web": {
"resolved": "apps/web",
"link": true
@@ -11971,6 +11975,17 @@
"peerDependencies": {
"solid-js": "^1.9.0"
}
+ },
+ "packages/runtime": {
+ "name": "@diffusionstudio/runtime",
+ "version": "0.1.0",
+ "license": "MPL-2.0",
+ "dependencies": {
+ "koota": "^0.6.6"
+ },
+ "devDependencies": {
+ "typescript": "~5.9.3"
+ }
}
}
}
diff --git a/packages/runtime/README.md b/packages/runtime/README.md
new file mode 100644
index 00000000..29d61374
--- /dev/null
+++ b/packages/runtime/README.md
@@ -0,0 +1,5 @@
+# @diffusionstudio/runtime
+
+Headless editor runtime built on [koota](https://github.com/pmndrs/koota): traits, world creation and serialization, actions, deterministic systems, media decoding, and capture.
+
+Must work without a DOM and without solid-js so the CLI and node capture can consume it directly. Browser-only concerns (input, keyboard, HUD, timeline canvas UI, persistence) live in `apps/web`; Solid reactivity bindings live in `@diffusionstudio/koota-solid`.
diff --git a/packages/runtime/package.json b/packages/runtime/package.json
new file mode 100644
index 00000000..d3c19fdc
--- /dev/null
+++ b/packages/runtime/package.json
@@ -0,0 +1,29 @@
+{
+ "name": "@diffusionstudio/runtime",
+ "version": "0.1.0",
+ "description": "Headless editor runtime: koota traits, world, actions, systems, media decoding, and capture. No DOM, no solid-js.",
+ "license": "MPL-2.0",
+ "type": "module",
+ "sideEffects": false,
+ "exports": {
+ ".": "./src/index.ts",
+ "./traits": "./src/traits/index.ts",
+ "./systems": "./src/systems/index.ts",
+ "./media": "./src/media/index.ts",
+ "./capture": "./src/capture/index.ts"
+ },
+ "scripts": {
+ "check": "tsc --noEmit"
+ },
+ "keywords": [
+ "koota",
+ "ecs",
+ "video"
+ ],
+ "dependencies": {
+ "koota": "^0.6.6"
+ },
+ "devDependencies": {
+ "typescript": "~5.9.3"
+ }
+}
diff --git a/packages/runtime/src/actions/assets.ts b/packages/runtime/src/actions/assets.ts
new file mode 100644
index 00000000..4edd3d83
--- /dev/null
+++ b/packages/runtime/src/actions/assets.ts
@@ -0,0 +1 @@
+// Asset actions (was api/assets.ts, minus persistence: storage stays app-side).
diff --git a/packages/runtime/src/actions/clipboard.ts b/packages/runtime/src/actions/clipboard.ts
new file mode 100644
index 00000000..22db48d2
--- /dev/null
+++ b/packages/runtime/src/actions/clipboard.ts
@@ -0,0 +1 @@
+// Clipboard model: copy/paste of entity subtrees (was api/clipboard.ts, minus navigator.clipboard access).
diff --git a/packages/runtime/src/actions/entities.ts b/packages/runtime/src/actions/entities.ts
new file mode 100644
index 00000000..06a9d192
--- /dev/null
+++ b/packages/runtime/src/actions/entities.ts
@@ -0,0 +1 @@
+// Entity lifecycle actions: create, duplicate, delete (was api/entities.ts).
diff --git a/packages/runtime/src/actions/folders.ts b/packages/runtime/src/actions/folders.ts
new file mode 100644
index 00000000..2bd6eb0b
--- /dev/null
+++ b/packages/runtime/src/actions/folders.ts
@@ -0,0 +1 @@
+// Folder actions (was api/folders.ts).
diff --git a/packages/runtime/src/actions/frame.ts b/packages/runtime/src/actions/frame.ts
new file mode 100644
index 00000000..2fa1732c
--- /dev/null
+++ b/packages/runtime/src/actions/frame.ts
@@ -0,0 +1 @@
+// Frame and scene actions (was api/frame.ts).
diff --git a/packages/runtime/src/actions/group.ts b/packages/runtime/src/actions/group.ts
new file mode 100644
index 00000000..326f278e
--- /dev/null
+++ b/packages/runtime/src/actions/group.ts
@@ -0,0 +1 @@
+// Group and ungroup actions (was api/group.ts).
diff --git a/packages/runtime/src/actions/hierarchy.ts b/packages/runtime/src/actions/hierarchy.ts
new file mode 100644
index 00000000..88d82ffd
--- /dev/null
+++ b/packages/runtime/src/actions/hierarchy.ts
@@ -0,0 +1 @@
+// Parenting and ordering actions (was api/hierarchy.ts).
diff --git a/packages/runtime/src/actions/index.ts b/packages/runtime/src/actions/index.ts
new file mode 100644
index 00000000..fa4aff1d
--- /dev/null
+++ b/packages/runtime/src/actions/index.ts
@@ -0,0 +1 @@
+// Re-exports all action groups, bound with koota createActions.
diff --git a/packages/runtime/src/actions/keyframe.ts b/packages/runtime/src/actions/keyframe.ts
new file mode 100644
index 00000000..838a2236
--- /dev/null
+++ b/packages/runtime/src/actions/keyframe.ts
@@ -0,0 +1 @@
+// Keyframe actions (was api/keyframe.ts).
diff --git a/packages/runtime/src/actions/resize.ts b/packages/runtime/src/actions/resize.ts
new file mode 100644
index 00000000..291e9eeb
--- /dev/null
+++ b/packages/runtime/src/actions/resize.ts
@@ -0,0 +1 @@
+// Resize and layout actions (was api/resize.ts).
diff --git a/packages/runtime/src/capture/index.ts b/packages/runtime/src/capture/index.ts
new file mode 100644
index 00000000..dd8d65fb
--- /dev/null
+++ b/packages/runtime/src/capture/index.ts
@@ -0,0 +1 @@
+// Capture and encoding: encoder, buffer, format, image-encoder (moves wholesale from engine/encode/).
diff --git a/packages/runtime/src/fonts/index.ts b/packages/runtime/src/fonts/index.ts
new file mode 100644
index 00000000..072e60d0
--- /dev/null
+++ b/packages/runtime/src/fonts/index.ts
@@ -0,0 +1 @@
+// Font loading and fixtures (moves wholesale from engine/font/).
diff --git a/packages/runtime/src/index.ts b/packages/runtime/src/index.ts
new file mode 100644
index 00000000..2d476e48
--- /dev/null
+++ b/packages/runtime/src/index.ts
@@ -0,0 +1 @@
+// Root entry: re-exports traits, world, actions, queries, and systems.
diff --git a/packages/runtime/src/math/index.ts b/packages/runtime/src/math/index.ts
new file mode 100644
index 00000000..c19029b2
--- /dev/null
+++ b/packages/runtime/src/math/index.ts
@@ -0,0 +1 @@
+// Math primitives: aabb, matrix2d, common (moves wholesale from engine/math/).
diff --git a/packages/runtime/src/media/index.ts b/packages/runtime/src/media/index.ts
new file mode 100644
index 00000000..06882413
--- /dev/null
+++ b/packages/runtime/src/media/index.ts
@@ -0,0 +1 @@
+// Media decoding: video, audio, image, sequence, caption/, html, shader, surface, frame-cache, time-stretcher (moves wholesale from engine/decoders/).
diff --git a/packages/runtime/src/queries/index.ts b/packages/runtime/src/queries/index.ts
new file mode 100644
index 00000000..215cfefd
--- /dev/null
+++ b/packages/runtime/src/queries/index.ts
@@ -0,0 +1 @@
+// Re-exports read-side query helpers.
diff --git a/packages/runtime/src/queries/overlap.ts b/packages/runtime/src/queries/overlap.ts
new file mode 100644
index 00000000..db11df01
--- /dev/null
+++ b/packages/runtime/src/queries/overlap.ts
@@ -0,0 +1 @@
+// Spatial and temporal overlap queries (was api/overlap.ts).
diff --git a/packages/runtime/src/queries/timeline-index.ts b/packages/runtime/src/queries/timeline-index.ts
new file mode 100644
index 00000000..236f52bc
--- /dev/null
+++ b/packages/runtime/src/queries/timeline-index.ts
@@ -0,0 +1 @@
+// Derived timeline layer index (was api/timeline-index.ts).
diff --git a/packages/runtime/src/systems/index.ts b/packages/runtime/src/systems/index.ts
new file mode 100644
index 00000000..d63a113d
--- /dev/null
+++ b/packages/runtime/src/systems/index.ts
@@ -0,0 +1 @@
+// Re-exports deterministic systems. Browser-only systems (input, keyboard, camera, hud, dom) stay in apps/web.
diff --git a/packages/runtime/src/systems/motion.ts b/packages/runtime/src/systems/motion.ts
new file mode 100644
index 00000000..0d2cb817
--- /dev/null
+++ b/packages/runtime/src/systems/motion.ts
@@ -0,0 +1 @@
+// Motion system: keyframe interpolation and animation (was systems/motion.ts).
diff --git a/packages/runtime/src/systems/playback.ts b/packages/runtime/src/systems/playback.ts
new file mode 100644
index 00000000..803a768f
--- /dev/null
+++ b/packages/runtime/src/systems/playback.ts
@@ -0,0 +1 @@
+// Playback system: time advancement and clip activation (was systems/playback.ts, minus DOM audio wiring).
diff --git a/packages/runtime/src/systems/schedule.ts b/packages/runtime/src/systems/schedule.ts
new file mode 100644
index 00000000..1f1213f5
--- /dev/null
+++ b/packages/runtime/src/systems/schedule.ts
@@ -0,0 +1 @@
+// System ordering for realtime vs capture mode.
diff --git a/packages/runtime/src/systems/transform.ts b/packages/runtime/src/systems/transform.ts
new file mode 100644
index 00000000..44e0ccc1
--- /dev/null
+++ b/packages/runtime/src/systems/transform.ts
@@ -0,0 +1 @@
+// Transform system: local/world matrices and AABBs (was systems/transform.ts).
diff --git a/packages/runtime/src/traits/index.ts b/packages/runtime/src/traits/index.ts
new file mode 100644
index 00000000..562f52a7
--- /dev/null
+++ b/packages/runtime/src/traits/index.ts
@@ -0,0 +1 @@
+// Re-exports all trait definitions.
diff --git a/packages/runtime/src/traits/media.ts b/packages/runtime/src/traits/media.ts
new file mode 100644
index 00000000..bfa00f7e
--- /dev/null
+++ b/packages/runtime/src/traits/media.ts
@@ -0,0 +1 @@
+// Media traits: decoder handles, asset references, ExportSettings, Effect.
diff --git a/packages/runtime/src/traits/node.ts b/packages/runtime/src/traits/node.ts
new file mode 100644
index 00000000..4f95e0f5
--- /dev/null
+++ b/packages/runtime/src/traits/node.ts
@@ -0,0 +1 @@
+// Node traits: Geometry, Paint, Group, Scene, Audio, Caption, AdjustmentLayer, masks, effects.
diff --git a/packages/runtime/src/traits/relations.ts b/packages/runtime/src/traits/relations.ts
new file mode 100644
index 00000000..0d48cc7e
--- /dev/null
+++ b/packages/runtime/src/traits/relations.ts
@@ -0,0 +1 @@
+// Entity relations via koota relation(): ChildOf and friends.
diff --git a/packages/runtime/src/traits/timing.ts b/packages/runtime/src/traits/timing.ts
new file mode 100644
index 00000000..22fd6c02
--- /dev/null
+++ b/packages/runtime/src/traits/timing.ts
@@ -0,0 +1 @@
+// Timing traits: clip in/out points, offsets, and keyframes.
diff --git a/packages/runtime/src/traits/transform.ts b/packages/runtime/src/traits/transform.ts
new file mode 100644
index 00000000..0b902601
--- /dev/null
+++ b/packages/runtime/src/traits/transform.ts
@@ -0,0 +1 @@
+// Transform traits: Position, Rotation, Scale, Anchor, Skew, Flip, Size, and computed matrices.
diff --git a/packages/runtime/src/traits/world.ts b/packages/runtime/src/traits/world.ts
new file mode 100644
index 00000000..07d08824
--- /dev/null
+++ b/packages/runtime/src/traits/world.ts
@@ -0,0 +1 @@
+// Singleton world traits: Camera, PlaybackState, Mode, Background. App-injected resources (canvas, resolution) also land here.
diff --git a/packages/runtime/src/utils/index.ts b/packages/runtime/src/utils/index.ts
new file mode 100644
index 00000000..857d3f77
--- /dev/null
+++ b/packages/runtime/src/utils/index.ts
@@ -0,0 +1 @@
+// Pure helpers only: time, text, sort, transition, captions. DOM-touching utils (cursor, interaction) stay in apps/web.
diff --git a/packages/runtime/src/world/create-world.ts b/packages/runtime/src/world/create-world.ts
new file mode 100644
index 00000000..b71b6baa
--- /dev/null
+++ b/packages/runtime/src/world/create-world.ts
@@ -0,0 +1 @@
+// createWorld() with all runtime traits. No AudioContext or window access; the app injects those.
diff --git a/packages/runtime/src/world/serialize.ts b/packages/runtime/src/world/serialize.ts
new file mode 100644
index 00000000..b511a2e4
--- /dev/null
+++ b/packages/runtime/src/world/serialize.ts
@@ -0,0 +1 @@
+// Document format: world serialization and restore (was api/serialize.ts + restoreWorld).
diff --git a/packages/runtime/tsconfig.json b/packages/runtime/tsconfig.json
new file mode 100644
index 00000000..5bf184ea
--- /dev/null
+++ b/packages/runtime/tsconfig.json
@@ -0,0 +1,8 @@
+{
+ "extends": "../../tsconfig.base.json",
+ "compilerOptions": {
+ "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
+ "lib": ["es2024", "dom"]
+ },
+ "include": ["src"]
+}