@onmark/cli 0.3.0 → 0.4.0

package/onmark-release.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "packageName": "@onmark/cli",
-  "version": "0.3.0",
-  "sourceRevision": "d45da8f8e397d78126f9d76ad36c2c20c815417e",
+  "version": "0.4.0",
+  "sourceRevision": "2e7e548ab5e309264477239e8c7ca1f4c15cc462",
   "files": [
     {
       "path": "LICENSE",
@@ -17,22 +17,22 @@
     {
       "path": "package.json",
       "bytes": 1406,
-      "sha256": "566d5d6d682429655a056c7eb1159ff19d2431fbb0f5118e91310739557628fe"
+      "sha256": "0b8c9e832be7f92fdf4a635aba18306806fc63a723f0f8cc320a9d33ba2c7bc8"
     },
     {
       "path": "packages/authoring/dist/src/frame-motion.d.ts",
-      "bytes": 1006,
-      "sha256": "119a4a0327ec0cb6baecf313ed90041b302f6207b2d963ca268a8ba348850e40"
+      "bytes": 1476,
+      "sha256": "fade0e486ba8fc3013b29ee5ee1467b5f464b3dcd2c28e5d7a06387131ca4427"
     },
     {
       "path": "packages/authoring/dist/src/frame-motion.js",
-      "bytes": 2685,
-      "sha256": "ca5775d727f39b1d6310d775d090d3db074a55e3e3d2e9a2ad62a9f355c1e578"
+      "bytes": 3603,
+      "sha256": "9d227cdaf4880ac434ca1666f2e5bfa88f81f20402c68f0efd3e335ceffe341e"
     },
     {
       "path": "packages/authoring/dist/src/index.d.ts",
-      "bytes": 775,
-      "sha256": "bdf86f3a16736963d83abf2ac8412b26b623bad45140f450666d9060688a5aae"
+      "bytes": 948,
+      "sha256": "f399c899ff4550dd103f21655bf150deaa516ad20b8e08795ccf2cd9a3500b88"
     },
     {
       "path": "packages/authoring/dist/src/index.js",
@@ -51,8 +51,8 @@
     },
     {
       "path": "packages/authoring/dist/src/motion.d.ts",
-      "bytes": 1411,
-      "sha256": "39e2ece580c2161b742ca183193d73765ba2a61a82fe88f336a38c63ed69de53"
+      "bytes": 2034,
+      "sha256": "f6696a6b9174dead62622fb3f0333106c77b2487e893abb3531fdbb0d5768341"
     },
     {
       "path": "packages/authoring/dist/src/motion.js",
@@ -66,8 +66,8 @@
     },
     {
       "path": "packages/authoring/dist/src/presentation.js",
-      "bytes": 9235,
-      "sha256": "4d507543fbc671d6d3ad5c7868369dc892983765ce4ac6965b9cdc848339bf14"
+      "bytes": 10584,
+      "sha256": "4d4ec19ded892ea0372ad76c18cb6e2175b172300164d030f4c26fdc1bfde7bb"
     },
     {
       "path": "packages/authoring/dist/src/resource.d.ts",
@@ -91,8 +91,8 @@
     },
     {
       "path": "packages/authoring/dist/src/types.d.ts",
-      "bytes": 133,
-      "sha256": "815630d36c644dd50b36a183bc6f5071c6b6550a5f8967e6a53994899811b311"
+      "bytes": 221,
+      "sha256": "913524b928d11c2c9af64d2f4f4d7fc5df3b3e20f0015e0389bde7f76625e93a"
     },
     {
       "path": "packages/authoring/dist/src/types.js",
@@ -101,13 +101,23 @@
     },
     {
       "path": "packages/bundler/dist/src/authored_html.d.ts",
-      "bytes": 1791,
-      "sha256": "a7620bed8f4dea8d6f5e1909311b5b87e126cbb90cc75a063ad10da7dfcc768e"
+      "bytes": 2117,
+      "sha256": "02f8a7256bd35bbb8aaffe1d2a56fbe901aa32f1e3ae383e311696bc14b393bd"
     },
     {
       "path": "packages/bundler/dist/src/authored_html.js",
-      "bytes": 14049,
-      "sha256": "17af4b808b9199fb7b29b7992d63a4b90b196bc84eeb004e1effda3ec5c24f2c"
+      "bytes": 15985,
+      "sha256": "485c622b295bc7b33dba2af2ca98800ed0e8a691baa7fef22cfd9ccb470be1ec"
+    },
+    {
+      "path": "packages/bundler/dist/src/bundle_projection.d.ts",
+      "bytes": 584,
+      "sha256": "fb5f3437d5c3945fe88eb636d47e078abcec6df40acccdc2d38741e1ba1ad653"
+    },
+    {
+      "path": "packages/bundler/dist/src/bundle_projection.js",
+      "bytes": 2504,
+      "sha256": "9aa0933b636d6326197f73ef25d4f1a99533a26ce132c3ee06128bec8cd91c9d"
     },
     {
       "path": "packages/bundler/dist/src/command.d.ts",
@@ -116,8 +126,8 @@
     },
     {
       "path": "packages/bundler/dist/src/command.js",
-      "bytes": 5078,
-      "sha256": "833f9cab8d0e5b31494fd57ea7cd5720cc5b10977d48421c2d9c723605cb454e"
+      "bytes": 5931,
+      "sha256": "03292a60d8989e5abbf17a34dc46736d1549689963a73e9f2cb26c531dedee1c"
     },
     {
       "path": "packages/bundler/dist/src/generated/bundle-manifest.d.ts",
@@ -129,6 +139,26 @@
       "bytes": 621,
       "sha256": "d3f7d430ebbc045db575d648e61f459848bac3c936acf9a6ec5f825260ef2458"
     },
+    {
+      "path": "packages/bundler/dist/src/generated/bundle-projection-validator.d.ts",
+      "bytes": 305,
+      "sha256": "86cb81c6de82addd637fd8fa92c51d2c541b22d434ec05eefa221bc51ead05cf"
+    },
+    {
+      "path": "packages/bundler/dist/src/generated/bundle-projection-validator.js",
+      "bytes": 18179,
+      "sha256": "0694b9888e27ba633c0ec73c4999f3c34edad3b09badd63ee04525e76ca88a19"
+    },
+    {
+      "path": "packages/bundler/dist/src/generated/bundle-projection.d.ts",
+      "bytes": 586,
+      "sha256": "a34237f3538de87ba5ac2c6e45d99c8a9043022dcde820b3915c67f210c043aa"
+    },
+    {
+      "path": "packages/bundler/dist/src/generated/bundle-projection.js",
+      "bytes": 83,
+      "sha256": "edf68d2007e1ca8c5aa32394cd7c3131e37265fef1c71bf390f2cc02ff02f559"
+    },
     {
       "path": "packages/bundler/dist/src/html_image.d.ts",
       "bytes": 967,
@@ -151,8 +181,8 @@
     },
     {
       "path": "packages/bundler/dist/src/index.d.ts",
-      "bytes": 358,
-      "sha256": "f491e5e0c254c855b212e7950c9a315a806497c448994e9daf7fc9ecbacbfed4"
+      "bytes": 381,
+      "sha256": "b88d6252d7a66b9cca0990ffa4d0f51474bd6a3715e795b42d932059620b9d1d"
     },
     {
       "path": "packages/bundler/dist/src/index.js",
@@ -161,13 +191,13 @@
     },
     {
       "path": "packages/bundler/dist/src/presentation.d.ts",
-      "bytes": 2116,
-      "sha256": "e97d532cda1f86933d452e109d80f38928fe02352e7af006b43bcc078efd999d"
+      "bytes": 2311,
+      "sha256": "50dea00d649ef252a7529e36f0e9f4d829022d38064ed64693dc621ff4c64fcd"
     },
     {
       "path": "packages/bundler/dist/src/presentation.js",
-      "bytes": 19114,
-      "sha256": "8f26c61eedaf249e46e05c2af5ad4593d596e7875dd65de3388a3a23ea60b25c"
+      "bytes": 20046,
+      "sha256": "053c22902c3d758e9dbd27857be910c8f6b982001d7924833f077d237c83eb43"
     },
     {
       "path": "packages/launcher/dist/desktop-release.json",
@@ -256,13 +286,13 @@
     },
     {
       "path": "packages/motion-gsap/dist/src/index.d.ts",
-      "bytes": 940,
-      "sha256": "526d9a01e5c0fe0b215d7319e14eef31fa8beb628e1aed9cd7078e412f42ed01"
+      "bytes": 1373,
+      "sha256": "ba8d7eb2017457cb59456aead7c09b04097ca744e935415db1d7880f02244b79"
     },
     {
       "path": "packages/motion-gsap/dist/src/index.js",
-      "bytes": 4920,
-      "sha256": "acf1389c0de9101725705fd13b949c209dd98533f41ea22851fdfde35bfbdf08"
+      "bytes": 5806,
+      "sha256": "4041d9b2bd3736d4c72c21ed298d65258f8e5703d3e54986f8706553c5c2f354"
     },
     {
       "path": "packages/runtime/dist/src/clock.d.ts",
@@ -276,8 +306,8 @@
     },
     {
       "path": "packages/runtime/dist/src/generated/browser-request.d.ts",
-      "bytes": 4577,
-      "sha256": "ead94024489324448fbe1d5c9db43244f86b433d8bd7e2d11e4dd7854d42eb60"
+      "bytes": 4883,
+      "sha256": "15861c41b4713352e6b75bdf71c4ad165d8084d9f1031db58b563f984d618f0b"
     },
     {
       "path": "packages/runtime/dist/src/generated/browser-request.js",
@@ -287,7 +317,7 @@
     {
       "path": "packages/runtime/dist/src/generated/browser-response.d.ts",
       "bytes": 1368,
-      "sha256": "a0fb11ebf3ac067a3e361a1c09bca4707f4cff8d73e9dca0f4b8d16b4b34bfcf"
+      "sha256": "adfd72031e58b5774ebdd62578d2f3bd17009d16bf1881d48330bc42689f77fc"
     },
     {
       "path": "packages/runtime/dist/src/generated/browser-response.js",
@@ -316,23 +346,23 @@
     },
     {
       "path": "packages/runtime/dist/src/generated/runtime-contract.d.ts",
-      "bytes": 393,
-      "sha256": "9cacb81eec65ee8af41097d0efbadaad889cb47e6f4e73d682c2edd5b9bfb7fa"
+      "bytes": 496,
+      "sha256": "4595ac4a096d79a3f153db88a4e19fd20be23db896b83e54527b26605e2f214c"
     },
     {
       "path": "packages/runtime/dist/src/generated/runtime-contract.js",
-      "bytes": 416,
-      "sha256": "5f2c643535d159fb735d393fa3c53fade154d6c306a272e98cb3408f3abbbdf0"
+      "bytes": 505,
+      "sha256": "48aff07bb36ec9f8edad25f597b985ff6a5dea9d44fbd2458e63cc4957026ece"
     },
     {
       "path": "packages/runtime/dist/src/generated/validators.d.ts",
       "bytes": 594,
-      "sha256": "b94094d88d2ef28fb3564a8b2f93d01495fb1f95cd720c4d0b933a87c1bc8d3d"
+      "sha256": "def2eb2646ee3084b86e3871fae68581ab51f0a1af917e7cdf8913567d9d4667"
     },
     {
       "path": "packages/runtime/dist/src/generated/validators.js",
-      "bytes": 224044,
-      "sha256": "9e8ec96ab5ea673186a54b3b2d27ed3c01931ef82998b19b087a41000c50cadf"
+      "bytes": 234626,
+      "sha256": "fdfb7d5ebac40c9845c8998dda53d4d231f8affbb1e3a2a94868415b0862351b"
     },
     {
       "path": "packages/runtime/dist/src/host.d.ts",
@@ -346,13 +376,13 @@
     },
     {
       "path": "packages/runtime/dist/src/index.d.ts",
-      "bytes": 1666,
-      "sha256": "42b953d62d267c593139fd117d31dcd44ec5afda3a0a28e38f37cc2d708825de"
+      "bytes": 1770,
+      "sha256": "de8c076c1aea98cb88bd49f90acd38b882e0240334b88174be53e6085c2ae1e8"
     },
     {
       "path": "packages/runtime/dist/src/index.js",
-      "bytes": 1043,
-      "sha256": "8181e47ed8b71d7f6eefdad1ecf2d1590f63ce35737a5b58cf0a2567a9336dc6"
+      "bytes": 1094,
+      "sha256": "146654c7bdc89e1e1815545af22577744eeb00ec95106f81cb13a41a87690938"
     },
     {
       "path": "packages/runtime/dist/src/media.d.ts",
@@ -366,13 +396,13 @@
     },
     {
       "path": "packages/runtime/dist/src/presentation.d.ts",
-      "bytes": 3092,
-      "sha256": "10f476b8f54f7e13bf46a1fdeccef3ebc0829cc62d0dede85fae802c54b65fc1"
+      "bytes": 3560,
+      "sha256": "8a27e87ae90d27f2fd7ab20b4048e88f344b59262ac47c5e7ba19bfda8d1dffc"
     },
     {
       "path": "packages/runtime/dist/src/presentation.js",
-      "bytes": 13840,
-      "sha256": "f1b840aa86a1fe6e4fea89b63a95f7a215eb8e341641450270e1a3a2c63db350"
+      "bytes": 14443,
+      "sha256": "4052fe152744acc35981ba60c68822750187a28728dd26312a9b789714e60251"
     },
     {
       "path": "packages/runtime/dist/src/resource.d.ts",
@@ -391,13 +421,13 @@
     },
     {
       "path": "packages/runtime/dist/src/session.js",
-      "bytes": 18245,
-      "sha256": "6e83aaae7b8b7655ea9e5a49bef67663c2619d9add79cc00e6bde0be12978aed"
+      "bytes": 20157,
+      "sha256": "d2c7cc8cf073af64ff5dda45bdec3b3aca8bb8e693243ad037c84dce0165eaa6"
     },
     {
       "path": "packages/runtime/dist/src/types.d.ts",
-      "bytes": 593,
-      "sha256": "691beeffdca9bbe045cd09550a1946d9f61ff37340f5d01fead41ff4c4e278c8"
+      "bytes": 636,
+      "sha256": "eb75c5eacb50cc83d5bf4b27a3ebc904c4af4a33113d0aa2772dfb54493757f8"
     },
     {
       "path": "packages/runtime/dist/src/types.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onmark/cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Screenplay-first deterministic browser video compiler",
   "license": "MIT",
   "repository": {
@@ -45,8 +45,8 @@
     "yauzl": "3.4.0"
   },
   "optionalDependencies": {
-    "@onmark/cli-darwin-arm64": "0.3.0",
-    "@onmark/cli-linux-x64": "0.3.0",
-    "@onmark/cli-win32-x64": "0.3.0"
+    "@onmark/cli-darwin-arm64": "0.4.0",
+    "@onmark/cli-linux-x64": "0.4.0",
+    "@onmark/cli-win32-x64": "0.4.0"
   }
 }

package/packages/authoring/dist/src/frame-motion.d.ts

@@ -1,4 +1,4 @@
-import type { PresentationExtension, PresentationExtensionContext, PresentationTargetKind } from "./motion.js";
+import type { PresentationExtension, PresentationExtensionContext, PresentationElementTargetKind } from "./motion.js";
 /** One immutable sample inside a semantic element's solved interval. */
 export interface FrameMotionContext {
     readonly durationFrames: number;
@@ -9,9 +9,17 @@ export interface FrameMotionContext {
 }
 /** Applies browser-owned visual state for one exact local frame. */
 export type FrameMotionHandler = (context: FrameMotionContext) => void;
+/** Exact-frame transition sample with both related shot elements. */
+export interface TransitionFrameMotionContext extends FrameMotionContext {
+    readonly incomingElement: HTMLElement;
+    readonly outgoingElement: HTMLElement;
+}
+/** Applies browser-owned transition state for one exact overlap frame. */
+export type TransitionFrameMotionHandler = (context: TransitionFrameMotionContext) => void;
 /** Semantic handlers and optional selector handlers for exact-frame motion. */
-export type FrameMotionDefinition = Readonly<Partial<Record<PresentationTargetKind, FrameMotionHandler>> & {
+export type FrameMotionDefinition = Readonly<Partial<Record<PresentationElementTargetKind, FrameMotionHandler>> & {
     readonly selectors?: Readonly<Record<string, FrameMotionHandler>>;
+    readonly transition?: TransitionFrameMotionHandler;
 }>;
 /** Creates local browser effects driven directly by exact runtime frames. */
 export declare function frameMotion(definition: FrameMotionDefinition): PresentationExtension;

package/packages/authoring/dist/src/frame-motion.js

@@ -16,7 +16,7 @@ function bindEffects(rules, context) {
     const effects = [];
     for (const target of context.targets) {
         const handlers = matchingHandlers(rules, target);
-        if (handlers.length > 0) {
+        if (handlers.elements.length > 0 || handlers.transition !== undefined) {
             effects.push(bindEffect(target, handlers, context.frameRate));
         }
     }
@@ -35,9 +35,12 @@ function bindEffect(target, handlers, frameRate) {
                 element: target.element,
                 frameRate,
                 localFrame,
-                progress: localFrame / durationFrames,
+                progress: targetProgress(target, localFrame, durationFrames),
             });
-            for (const handler of handlers) {
+            if (target.kind === "transition" && handlers.transition !== undefined) {
+                handlers.transition(transitionSample(sample, target));
+            }
+            for (const handler of handlers.elements) {
                 handler(sample);
             }
         },
@@ -57,7 +60,11 @@ function ownRules(definition) {
         caption: definition.caption,
     });
     const selectors = Object.freeze(Object.entries(definition.selectors ?? {}).map(ownSelector));
-    return Object.freeze({ kinds, selectors });
+    return Object.freeze({
+        kinds,
+        selectors,
+        transition: definition.transition,
+    });
 }
 function ownSelector([selector, apply]) {
     if (selector.trim().length === 0) {
@@ -67,7 +74,7 @@ function ownSelector([selector, apply]) {
 }
 function matchingHandlers(rules, target) {
     const handlers = [];
-    const kind = rules.kinds[target.kind];
+    const kind = target.kind === "transition" ? undefined : rules.kinds[target.kind];
     if (kind !== undefined) {
         handlers.push(kind);
     }
@@ -76,5 +83,21 @@ function matchingHandlers(rules, target) {
             handlers.push(rule.apply);
         }
     }
-    return handlers;
+    return Object.freeze({
+        elements: Object.freeze(handlers),
+        transition: target.kind === "transition" ? rules.transition : undefined,
+    });
+}
+function targetProgress(target, localFrame, durationFrames) {
+    if (target.kind !== "transition") {
+        return localFrame / durationFrames;
+    }
+    return durationFrames === 1 ? 1 : localFrame / (durationFrames - 1);
+}
+function transitionSample(sample, target) {
+    return Object.freeze({
+        ...sample,
+        incomingElement: target.incomingElement,
+        outgoingElement: target.outgoingElement,
+    });
 }

package/packages/authoring/dist/src/index.d.ts

@@ -1,6 +1,6 @@
-export { frameMotion, type FrameMotionContext, type FrameMotionDefinition, type FrameMotionHandler, } from "./frame-motion.js";
+export { frameMotion, type FrameMotionContext, type FrameMotionDefinition, type FrameMotionHandler, type TransitionFrameMotionContext, type TransitionFrameMotionHandler, } from "./frame-motion.js";
 export { easing, interpolate, type EasingFunction, type Extrapolation, type InterpolationOptions, } from "./interpolation.js";
 export { spring, type SpringFrame, type SpringOptions } from "./spring.js";
-export { combineMotion, type PresentationExtension, type PresentationExtensionContext, type PresentationTarget, type PresentationTargetKind, } from "./motion.js";
+export { combineMotion, type PresentationExtension, type PresentationExtensionContext, type PresentationElementTarget, type PresentationElementTargetKind, type PresentationTarget, type PresentationTargetKind, type PresentationTransitionTarget, } from "./motion.js";
 export { createDomPresentationBindings, type DomPresentationOptions, type VideoSource, } from "./presentation.js";
 export { createFontResource, createImageResource, type FontResource, type FontResourceOptions, type ImageResource, type ImageResourceOptions, } from "./resource.js";

package/packages/authoring/dist/src/motion.d.ts

@@ -1,12 +1,23 @@
 import type { PresentationExtensions, RuntimeNode, RuntimePlan } from "../../../runtime/dist/src/index.js";
-export type PresentationTargetKind = "film" | "scene" | "shot" | "video" | "title" | "callToAction" | "caption";
-/** One semantic element and its compiler-owned active interval. */
-export interface PresentationTarget {
-    readonly kind: PresentationTargetKind;
+export type PresentationElementTargetKind = "film" | "scene" | "shot" | "video" | "title" | "callToAction" | "caption";
+export type PresentationTargetKind = PresentationElementTargetKind | "transition";
+interface PresentationTargetBase {
     readonly element: HTMLElement;
     readonly interval: RuntimePlan["evaluation"];
     readonly node: RuntimeNode;
 }
+/** One semantic element and its compiler-owned active interval. */
+export interface PresentationElementTarget extends PresentationTargetBase {
+    readonly kind: PresentationElementTargetKind;
+}
+/** One transition marker and the exact adjacent elements it relates. */
+export interface PresentationTransitionTarget extends PresentationTargetBase {
+    readonly kind: "transition";
+    readonly incomingElement: HTMLElement;
+    readonly outgoingElement: HTMLElement;
+}
+/** Closed browser-owned view of one compiler-projected semantic target. */
+export type PresentationTarget = PresentationElementTarget | PresentationTransitionTarget;
 /** Complete immutable DOM view delivered after all solved facts are bound. */
 export interface PresentationExtensionContext {
     readonly frameRate: RuntimePlan["frameRate"];
@@ -21,3 +32,4 @@ export declare function combineMotion(...extensions: readonly PresentationExtens
 export declare const EMPTY_PRESENTATION_EXTENSIONS: PresentationExtensions;
 export declare function ownExtension(extension: PresentationExtension): PresentationExtension;
 export declare function ownExtensions(extensions: PresentationExtensions): PresentationExtensions;
+export {};

package/packages/authoring/dist/src/presentation.js

@@ -9,6 +9,7 @@ const ELEMENTS = Object.freeze({
     scene: "om-scene",
     shot: "om-shot",
     title: "om-title",
+    transition: "om-transition",
     video: "video",
 });
 // Whole-film artifacts may contain semantic nodes absent from a projected
@@ -17,6 +18,7 @@ const VISIBILITY_RULE = [
     "[data-om-node][hidden],",
     "om-film > om-scene:not([data-om-node]),",
     "om-scene > om-shot:not([data-om-node]),",
+    "om-scene > om-transition,",
     "om-shot > :is(video, om-title, om-cta):not([data-om-node]) {",
     "  display: none !important;",
     "}",
@@ -32,6 +34,7 @@ export function createDomPresentationBindings(options) {
         bindFilm: document.bindFilm.bind(document),
         bindScene: document.bindScene.bind(document),
         bindShot: document.bindShot.bind(document),
+        bindTransition: document.bindTransition.bind(document),
         bindVideo: document.bindVideo.bind(document),
         bindOverlay: document.bindOverlay.bind(document),
         async bindExtensions(plan) {
@@ -97,6 +100,27 @@ class AuthoredDocument {
             source: this.#videoSource(placement),
         };
     }
+    bindTransition(placement) {
+        const nodes = this.#nodeIndex();
+        const element = requiredNode(nodes, placement.node, "transition", ELEMENTS.transition);
+        const outgoingElement = requiredNodeId(nodes, placement.outgoingShotId, "outgoing shot", ELEMENTS.shot);
+        const incomingElement = requiredNodeId(nodes, placement.incomingShotId, "incoming shot", ELEMENTS.shot);
+        const bound = bindElement(element, placement.node);
+        this.#targets.push(Object.freeze({
+            element,
+            incomingElement,
+            interval: placement.interval,
+            kind: "transition",
+            node: placement.node,
+            outgoingElement,
+        }));
+        return Object.freeze({
+            dispose: bound.dispose,
+            element,
+            incomingElement,
+            outgoingElement,
+        });
+    }
     bindOverlay(placement) {
         if (placement.kind === "caption") {
             return this.#bindCaption(placement);
@@ -157,7 +181,13 @@ function collectAuthoredNodes(document, plan) {
     const browserVideoShots = new Set(plan.videos.map(({ shotId }) => shotId));
     for (const scene of semanticChildren(film, ELEMENTS.scene)) {
         indexed.push(scene);
-        for (const shot of semanticChildren(scene, ELEMENTS.shot)) {
+        const structure = semanticChildren(scene, `${ELEMENTS.shot}, ${ELEMENTS.transition}`);
+        for (const element of structure) {
+            if (element.matches(ELEMENTS.transition)) {
+                indexed.push(element);
+                continue;
+            }
+            const shot = element;
             indexed.push(shot);
             // Browser Plans assign dense semantic preorder IDs. The shot just
             // admitted is therefore the parent ID carried by projected videos.
@@ -170,6 +200,9 @@ function collectAuthoredNodes(document, plan) {
     }
     return Object.freeze({ film, elements: Object.freeze(indexed) });
 }
+function requiredNodeId(nodes, nodeId, role, selector) {
+    return requiredNode(nodes, { nodeId }, role, selector);
+}
 function requiredNode(nodes, node, role, selector) {
     const element = nodes.elements[node.nodeId];
     if (element === undefined) {

package/packages/authoring/dist/src/types.d.ts

@@ -1 +1 @@
-export type { PresentationExtension, PresentationExtensionContext, PresentationTarget, PresentationTargetKind, } from "./motion.js";
+export type { PresentationExtension, PresentationExtensionContext, PresentationElementTarget, PresentationElementTargetKind, PresentationTarget, PresentationTargetKind, PresentationTransitionTarget, } from "./motion.js";

package/packages/bundler/dist/src/authored_html.d.ts

@@ -4,13 +4,13 @@ export interface AuthoredHtml {
     readonly document: string;
     readonly motion: string | undefined;
     readonly resources: readonly HtmlImageResource[];
-    readonly regions: readonly AuthoredHtmlRegion[];
+    readonly shots: readonly AuthoredHtmlShot[];
     readonly regionStructure: AuthoredHtmlRegionStructure;
     readonly resolveDirectory: string;
     readonly runtimeOffset: number;
 }
-/** One shot selection within the shared authored-document structure. */
-export interface AuthoredHtmlRegion {
+/** One dense screenplay-order shot within the authored document. */
+export interface AuthoredHtmlShot {
     readonly scene: number;
     readonly shot: number;
 }
@@ -20,9 +20,19 @@ export interface AuthoredHtmlRegionStructure {
 }
 export interface AuthoredHtmlScene {
     readonly range: SourceRange;
-    readonly shots: readonly SourceRange[];
+    readonly shots: readonly AuthoredHtmlShotRange[];
+    readonly transitions: readonly AuthoredHtmlTransitionRange[];
 }
-/** One materialized shot-scoped browser document. */
+export interface AuthoredHtmlShotRange {
+    readonly index: number;
+    readonly range: SourceRange;
+}
+export interface AuthoredHtmlTransitionRange {
+    readonly incomingShot: number;
+    readonly outgoingShot: number;
+    readonly range: SourceRange;
+}
+/** One materialized render-region browser document. */
 export interface AuthoredHtmlRegionDocument {
     readonly document: string;
     readonly runtimeOffset: number;
@@ -33,8 +43,8 @@ export declare class AuthoredHtmlError extends Error {
 }
 /** Reads one bounded UTF-8 document and isolates its motion module. */
 export declare function readAuthoredHtml(path: string, maxOutputBytes: number, resolveDirectory?: string): Promise<AuthoredHtml>;
-/** Materializes one shot projection without retaining every projected document. */
-export declare function projectShotDocument(html: AuthoredHtml, region: AuthoredHtmlRegion): AuthoredHtmlRegionDocument;
+/** Materializes one Rust-planned region without retaining every projection. */
+export declare function projectRegionDocument(html: AuthoredHtml, shotIndices: readonly number[]): AuthoredHtmlRegionDocument;
 export interface SourceRange {
     readonly end: number;
     readonly start: number;