@onmark/cli 0.3.0 → 0.4.0

package/packages/motion-gsap/dist/src/index.d.ts

@@ -1,5 +1,5 @@
 import { gsap } from "gsap";
-import type { PresentationExtension, PresentationTargetKind } from "../../../authoring/dist/src/index.js";
+import type { PresentationExtension, PresentationElementTargetKind } from "../../../authoring/dist/src/index.js";
 /** Local GSAP authoring facts for one semantic screenplay element. */
 export interface GsapMotionContext {
     readonly durationSeconds: number;
@@ -8,9 +8,17 @@ export interface GsapMotionContext {
 }
 /** Adds local animation to one Onmark-owned paused timeline. */
 export type GsapMotionHandler = (context: GsapMotionContext) => void;
+/** Local GSAP transition facts with both adjacent shot elements. */
+export interface GsapTransitionContext extends GsapMotionContext {
+    readonly incomingElement: HTMLElement;
+    readonly outgoingElement: HTMLElement;
+}
+/** Adds local animation across one compiler-owned shot overlap. */
+export type GsapTransitionHandler = (context: GsapTransitionContext) => void;
 /** Semantic handlers and optional selector handlers for local motion. */
-export type GsapMotionDefinition = Readonly<Partial<Record<PresentationTargetKind, GsapMotionHandler>> & {
+export type GsapMotionDefinition = Readonly<Partial<Record<PresentationElementTargetKind, GsapMotionHandler>> & {
     readonly selectors?: Readonly<Record<string, GsapMotionHandler>>;
+    readonly transition?: GsapTransitionHandler;
 }>;
 /** Creates exact-frame GSAP effects without exposing runtime lifecycle code. */
 export declare function gsapMotion(definition: GsapMotionDefinition): PresentationExtension;

package/packages/motion-gsap/dist/src/index.js

@@ -19,7 +19,7 @@ function bindGsapEffects(rules, context) {
     try {
         for (const target of context.targets) {
             const handlers = matchingHandlers(rules, target);
-            if (handlers.length === 0) {
+            if (handlers.elements.length === 0 && handlers.transition === undefined) {
                 continue;
             }
             effects.push(bindGsapEffect(handlers, target, context));
@@ -43,7 +43,10 @@ function bindGsapEffect(handlers, target, context) {
             element: target.element,
             timeline,
         });
-        for (const handler of handlers) {
+        if (target.kind === "transition" && handlers.transition !== undefined) {
+            handlers.transition(transitionContext(motion, target));
+        }
+        for (const handler of handlers.elements) {
             handler(motion);
         }
         requireLocalTimeline(timeline, durationSeconds, target.kind);
@@ -88,7 +91,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, animate]) {
     if (selector.trim().length === 0) {
@@ -98,7 +105,7 @@ function ownSelector([selector, animate]) {
 }
 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);
     }
@@ -107,7 +114,10 @@ function matchingHandlers(rules, target) {
             handlers.push(rule.animate);
         }
     }
-    return handlers;
+    return Object.freeze({
+        elements: Object.freeze(handlers),
+        transition: target.kind === "transition" ? rules.transition : undefined,
+    });
 }
 // ── Exact-frame playheads ──
 function intervalSeconds(target, context) {
@@ -117,8 +127,20 @@ function intervalSeconds(target, context) {
 function localSeconds(frame, target, context) {
     const durationFrames = target.interval.end - target.interval.start;
     const localFrame = Math.max(0, Math.min(frame.index - target.interval.start, durationFrames));
+    if (target.kind === "transition") {
+        const finalFrame = durationFrames - 1;
+        const progress = finalFrame === 0 ? 1 : localFrame / finalFrame;
+        return intervalSeconds(target, context) * progress;
+    }
     return ((localFrame / context.frameRate.numerator) * context.frameRate.denominator);
 }
+function transitionContext(context, target) {
+    return Object.freeze({
+        ...context,
+        incomingElement: target.incomingElement,
+        outgoingElement: target.outgoingElement,
+    });
+}
 function requireLocalTimeline(timeline, durationSeconds, label) {
     if (timeline.duration() <= durationSeconds) {
         return;

package/packages/runtime/dist/src/generated/browser-request.d.ts

@@ -66,7 +66,7 @@ export type RequestId = number;
 /**
  * Version of the native-to-browser message contract.
  */
-export type ProtocolVersion = 3;
+export type ProtocolVersion = 4;
 /**
  * One versioned command sent from the native executor to the browser.
  */
@@ -96,7 +96,11 @@ export interface BrowserPlan {
      */
     shots: BrowserShot[];
     timeline: WireInterval;
-    timelineVersion: 2;
+    timelineVersion: 3;
+    /**
+     * @maxItems 10000
+     */
+    transitions: BrowserTransition[];
     /**
      * @maxItems 10000
      */
@@ -148,6 +152,15 @@ export interface BrowserShot {
     node: BrowserNode;
     sceneId: BrowserNodeId;
 }
+/**
+ * One solved transition between two adjacent browser shots.
+ */
+export interface BrowserTransition {
+    incomingShotId: BrowserNodeId;
+    interval: WireInterval;
+    node: BrowserNode;
+    outgoingShotId: BrowserNodeId;
+}
 /**
  * One primary video placement consumed by the browser presentation adapter.
  */

package/packages/runtime/dist/src/generated/browser-response.d.ts

@@ -47,7 +47,7 @@ export type RequestId = number;
 /**
  * Version of the native-to-browser message contract.
  */
-export type ProtocolVersion = 3;
+export type ProtocolVersion = 4;
 /**
  * One versioned event returned by the browser runtime.
  */

package/packages/runtime/dist/src/generated/runtime-contract.d.ts

@@ -1,5 +1,7 @@
 export declare const RUNTIME_HOST_NAME: "__ONMARK_RUNTIME__";
+export declare const BROWSER_PROTOCOL_VERSION: 4;
 export declare const MAX_BROWSER_VIDEOS: 10000;
+export declare const MAX_BROWSER_TRANSITIONS: 10000;
 export declare const MAX_BROWSER_OVERLAYS: 10000;
 export declare const MAX_BROWSER_OVERLAY_TEXT_CHARACTERS: 65536;
 export declare const MAX_FAILURE_MESSAGE_CHARACTERS: 4096;

package/packages/runtime/dist/src/generated/runtime-contract.js

@@ -1,6 +1,8 @@
 // Generated by `cargo xtask schema`; edit Rust protocol types instead.
 export const RUNTIME_HOST_NAME = "__ONMARK_RUNTIME__";
+export const BROWSER_PROTOCOL_VERSION = 4;
 export const MAX_BROWSER_VIDEOS = 10000;
+export const MAX_BROWSER_TRANSITIONS = 10000;
 export const MAX_BROWSER_OVERLAYS = 10000;
 export const MAX_BROWSER_OVERLAY_TEXT_CHARACTERS = 65536;
 export const MAX_FAILURE_MESSAGE_CHARACTERS = 4096;

package/packages/runtime/dist/src/generated/validators.d.ts

@@ -4,8 +4,8 @@ declare function validate20(data: any, { instancePath, parentData, parentDataPro
     instancePath?: string | undefined;
     rootData?: any;
 }): boolean;
-export declare const validateBrowserResponse: typeof validate51;
-declare function validate51(data: any, { instancePath, parentData, parentDataProperty, rootData, dynamicAnchors }?: {
+export declare const validateBrowserResponse: typeof validate55;
+declare function validate55(data: any, { instancePath, parentData, parentDataProperty, rootData, dynamicAnchors }?: {
     dynamicAnchors?: {} | undefined;
     instancePath?: string | undefined;
     rootData?: any;