@mengine/medeo-client 2.0.1-alpha.22 → 2.0.1-alpha.24

package/dist/{index-C0uUWqkz.d.ts → index-CcIoMxs1.d.ts}

@@ -1019,6 +1019,11 @@ declare function fromVideoDocument(document: VideoDocument, options?: SolveVideo
  */
 declare function buildInitialVideoDocument(): VideoDocument;
 //#endregion
+//#region ../medeo-dsl/src/sandbox.d.ts
+/** Kinds a script can author. */
+type EntityKind = 'timeline' | 'track' | 'clip' | 'sequence-marker' | 'video' | 'audio' | 'voiceover-recording' | 'image' | 'voice' | 'audio-script' | 'phonetic-script' | 'caption';
+type RelationKind = 'contain' | 'marker' | 'clip-anchor' | 'voice-timbre' | 'caption-alignment' | 'derived-from';
+//#endregion
 //#region ../medeo-dsl/src/ids.d.ts
 declare const entityIdBrand: unique symbol;
 declare const relationIdBrand: unique symbol;
@@ -1037,23 +1042,13 @@ type JsonObject = {
 };
 //#endregion
 //#region ../medeo-dsl/src/entities.d.ts
-type KnownEntityKind = 'axvideo' | 'timeline' | 'track' | 'clip' | 'asset' | 'video' | 'audio' | 'voiceover' | 'voice' | 'image' | 'sequence-marker' | 'viewport' | 'audio-script' | 'phonetic-script' | 'caption';
+type StoredEntityKind = EntityKind | 'asset';
 declare const extensionEntityKindBrand: unique symbol;
 type ExtensionEntityKind = string & {
   readonly [extensionEntityKindBrand]: 'ExtensionEntityKind';
 };
 /** Extensions require explicit branding so removed or reserved domain kinds cannot reappear accidentally. */
-type EntityKind = KnownEntityKind | ExtensionEntityKind;
-interface SequenceRange<Point = unknown> {
-  readonly start: Point;
-  readonly end: Point;
-}
-type SequenceDuration<Span = unknown> = {
-  readonly mode: 'from-source';
-} | {
-  readonly mode: 'fixed';
-  readonly value: Span;
-};
+type AnyEntityKind = StoredEntityKind | ExtensionEntityKind;
 interface ScriptTextSegment {
   readonly segmentId: string;
   readonly text: string;
@@ -1104,8 +1099,8 @@ type CaptionSegmentSelection = JsonObject & {
 };
 //#endregion
 //#region ../medeo-dsl/src/relations.d.ts
-type KnownRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'from-asset' | 'to-asset' | 'generated' | 'caption-alignment' | 'clip-anchor' | 'phonetic-script-render' | 'audio-script-source' | 'audio-script-marker';
-type RelationKind = KnownRelationKind | (string & {});
+type StoredRelationKind = RelationKind | 'from-asset' | 'to-asset';
+type AnyRelationKind = StoredRelationKind | (string & {});
 type RelationTrace = JsonObject;
 /**
  * Authoritative persisted relation value.
@@ -1114,7 +1109,7 @@ type RelationTrace = JsonObject;
  * storage adapters must preserve the submitted positions; kinds whose
  * semantics are unordered simply do not interpret those positions.
  */
-interface RelationRow<K extends RelationKind = RelationKind, Metadata extends JsonObject = JsonObject> {
+interface RelationRow<K extends AnyRelationKind = AnyRelationKind, Metadata extends JsonObject = JsonObject> {
   readonly relationId: RelationId;
   readonly endpoint0EntityId: EntityId;
   readonly endpoint1EntityId: EntityId;
@@ -1125,7 +1120,7 @@ interface RelationRow<K extends RelationKind = RelationKind, Metadata extends Js
 //#endregion
 //#region ../medeo-dsl/src/rows.d.ts
 /** One persisted first-class entity. Its owned fields live directly in payload. */
-interface EntityRow<K extends EntityKind = EntityKind> {
+interface EntityRow<K extends AnyEntityKind = AnyEntityKind> {
   readonly entityId: EntityId;
   readonly entityKind: K;
   readonly payload: JsonObject;
@@ -1870,4 +1865,4 @@ declare const videoDocumentSchema: z.ZodObject<{
   }, z.core.$loose>]>>>;
 }, z.core.$loose>;
 //#endregion
-export { SpeechHostMap as $, assertValidVideoDocument as A, VideoDocumentValidationIssueCode as At, EntityRow as B, SpeedShift as Bt, isImplementedSemanticOpKind as C, Timeline as Ct, PartIdFactory as D, VideoClipPart as Dt, ValidationError as E, TrackItemTimePosition as Et, ResolvedEntityTrack as F, speedOf as Ft, SequenceDuration as G, CaptionSegmentSelection as H, Track$1 as Ht, resolveEntityTimelineLayout as I, Attachment as It, JsonObject as J, SequenceRange as K, projectEntityTimeline as L, CaptionPart$1 as Lt, EntityTimelineTrackRole as M, VideoDraftContent as Mt, ResolvedEntityClipPlacement as N, VideoDraftPartUnion as Nt, generatePartId as O, VideoDocument as Ot, ResolvedEntityTimelineLayout as P, effectiveVideoClipDurationMs as Pt, DerivedItemPosition as Q, EntityTimelineProjectionError as R, CaptionStyle as Rt, SemanticOpKind as S, SpeechPart as St, SnapshotReadable as T, TrackItem as Tt, CaptionStyleFields as U, TrackItem$1 as Ut, RelationRow as V, Timeline$1 as Vt, ScriptTextSegment as W, EntityId as X, JsonValue as Y, buildInitialVideoDocument as Z, SemanticOpName as _, CaptionDisplayCue as _t, PlainMemoryAdapter as a, LaneKind as at, ImplementedSemanticOpKind as b, PartKind as bt, MirrorVideoDocumentAdapter as c, findLaneTrack as ct, createMirrorVideoDocumentAdapter as d, TrackDraft as dt, buildSpeechHostMap as et, CommitOptions as f, TrackItemDraft as ft, SemanticOpInput as g, BgmPart as gt, SemanticEditor as h, videoDocumentMirrorSchema as ht, JournalEntry as i, LANE_KINDS_IN_STACK_ORDER as it, validateVideoDocument as j, VideoDraft as jt, VideoDocumentValidationError as k, VideoDocumentValidationIssue as kt, MirrorVideoDocumentOptions as l, laneTrackId as lt, SemanticDocumentAdapter as m, VideoDocumentMirrorSchema as mt, videoDocumentSchema as n, fromVideoDocument as nt, PlainMemoryAdapterOptions as o, SolvedVideoDocument as ot, OpActor as p, VideoDocumentDraft as pt, VoiceDescriptor as q, readVideoDocumentFromDraft as r, toVideoDocument as rt, createPlainMemoryAdapter as s, ensureLaneTrack as st, partUnionSchema as t, derivePositionFromAbs as tt, createMirrorVideoDocument as u, solveVideoDocument as ut, TransactAudit as v, CaptionPart as vt, SchemaValidator as w, Track as wt, PlannedSemanticOpKind as x, PartUnion as xt, IMPLEMENTED_SEMANTIC_OP_KINDS as y, DEFAULT_UNIT_TIME_MS as yt, EntityRelationRows as z, PartAggregation as zt };
+export { derivePositionFromAbs as $, assertValidVideoDocument as A, VideoDraftContent as At, EntityRow as B, Track$1 as Bt, isImplementedSemanticOpKind as C, TrackItem as Ct, PartIdFactory as D, VideoDocumentValidationIssue as Dt, ValidationError as E, VideoDocument as Et, ResolvedEntityTrack as F, CaptionPart$1 as Ft, VoiceDescriptor as G, CaptionSegmentSelection as H, resolveEntityTimelineLayout as I, CaptionStyle as It, EntityId as J, JsonObject as K, projectEntityTimeline as L, PartAggregation as Lt, EntityTimelineTrackRole as M, effectiveVideoClipDurationMs as Mt, ResolvedEntityClipPlacement as N, speedOf as Nt, generatePartId as O, VideoDocumentValidationIssueCode as Ot, ResolvedEntityTimelineLayout as P, Attachment as Pt, buildSpeechHostMap as Q, EntityTimelineProjectionError as R, SpeedShift as Rt, SemanticOpKind as S, Track as St, SnapshotReadable as T, VideoClipPart as Tt, CaptionStyleFields as U, RelationRow as V, TrackItem$1 as Vt, ScriptTextSegment as W, DerivedItemPosition as X, buildInitialVideoDocument as Y, SpeechHostMap as Z, SemanticOpName as _, DEFAULT_UNIT_TIME_MS as _t, PlainMemoryAdapter as a, ensureLaneTrack as at, ImplementedSemanticOpKind as b, SpeechPart as bt, MirrorVideoDocumentAdapter as c, solveVideoDocument as ct, createMirrorVideoDocumentAdapter as d, VideoDocumentDraft as dt, fromVideoDocument as et, CommitOptions as f, VideoDocumentMirrorSchema as ft, SemanticOpInput as g, CaptionPart as gt, SemanticEditor as h, CaptionDisplayCue as ht, JournalEntry as i, SolvedVideoDocument as it, validateVideoDocument as j, VideoDraftPartUnion as jt, VideoDocumentValidationError as k, VideoDraft as kt, MirrorVideoDocumentOptions as l, TrackDraft as lt, SemanticDocumentAdapter as m, BgmPart as mt, videoDocumentSchema as n, LANE_KINDS_IN_STACK_ORDER as nt, PlainMemoryAdapterOptions as o, findLaneTrack as ot, OpActor as p, videoDocumentMirrorSchema as pt, JsonValue as q, readVideoDocumentFromDraft as r, LaneKind as rt, createPlainMemoryAdapter as s, laneTrackId as st, partUnionSchema as t, toVideoDocument as tt, createMirrorVideoDocument as u, TrackItemDraft as ut, TransactAudit as v, PartKind as vt, SchemaValidator as w, TrackItemTimePosition as wt, PlannedSemanticOpKind as x, Timeline as xt, IMPLEMENTED_SEMANTIC_OP_KINDS as y, PartUnion as yt, EntityRelationRows as z, Timeline$1 as zt };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as index_d_exports } from "./index-CMa6ZCtX.js";
-import { $ as SpeechHostMap, A as assertValidVideoDocument, At as VideoDocumentValidationIssueCode, B as EntityRow, Bt as SpeedShift, C as isImplementedSemanticOpKind, Ct as Timeline, D as PartIdFactory, Dt as VideoClipPart, E as ValidationError, Et as TrackItemTimePosition, F as ResolvedEntityTrack, Ft as speedOf, G as SequenceDuration, H as CaptionSegmentSelection, Ht as Track$1, I as resolveEntityTimelineLayout, It as Attachment, J as JsonObject, K as SequenceRange, L as projectEntityTimeline, Lt as CaptionPart$1, M as EntityTimelineTrackRole, Mt as VideoDraftContent, N as ResolvedEntityClipPlacement, Nt as VideoDraftPartUnion, O as generatePartId, Ot as VideoDocument, P as ResolvedEntityTimelineLayout, Pt as effectiveVideoClipDurationMs, Q as DerivedItemPosition, R as EntityTimelineProjectionError, Rt as CaptionStyle, S as SemanticOpKind, St as SpeechPart, T as SnapshotReadable, Tt as TrackItem, U as CaptionStyleFields, Ut as TrackItem$1, V as RelationRow, Vt as Timeline$1, W as ScriptTextSegment, X as EntityId, Y as JsonValue, Z as buildInitialVideoDocument, _ as SemanticOpName, _t as CaptionDisplayCue, a as PlainMemoryAdapter, at as LaneKind, b as ImplementedSemanticOpKind, bt as PartKind, c as MirrorVideoDocumentAdapter, ct as findLaneTrack, d as createMirrorVideoDocumentAdapter, dt as TrackDraft, et as buildSpeechHostMap, f as CommitOptions, ft as TrackItemDraft, g as SemanticOpInput, gt as BgmPart, h as SemanticEditor, ht as videoDocumentMirrorSchema, i as JournalEntry, it as LANE_KINDS_IN_STACK_ORDER, j as validateVideoDocument, jt as VideoDraft, k as VideoDocumentValidationError, kt as VideoDocumentValidationIssue, l as MirrorVideoDocumentOptions, lt as laneTrackId, m as SemanticDocumentAdapter, mt as VideoDocumentMirrorSchema, n as videoDocumentSchema, nt as fromVideoDocument, o as PlainMemoryAdapterOptions, ot as SolvedVideoDocument, p as OpActor, pt as VideoDocumentDraft, q as VoiceDescriptor, r as readVideoDocumentFromDraft, rt as toVideoDocument, s as createPlainMemoryAdapter, st as ensureLaneTrack, t as partUnionSchema, tt as derivePositionFromAbs, u as createMirrorVideoDocument, ut as solveVideoDocument, v as TransactAudit, vt as CaptionPart, w as SchemaValidator, wt as Track, x as PlannedSemanticOpKind, xt as PartUnion, y as IMPLEMENTED_SEMANTIC_OP_KINDS, yt as DEFAULT_UNIT_TIME_MS, z as EntityRelationRows, zt as PartAggregation } from "./index-C0uUWqkz.js";
+import { $ as derivePositionFromAbs, A as assertValidVideoDocument, At as VideoDraftContent, B as EntityRow, Bt as Track$1, C as isImplementedSemanticOpKind, Ct as TrackItem, D as PartIdFactory, Dt as VideoDocumentValidationIssue, E as ValidationError, Et as VideoDocument, F as ResolvedEntityTrack, Ft as CaptionPart$1, G as VoiceDescriptor, H as CaptionSegmentSelection, I as resolveEntityTimelineLayout, It as CaptionStyle, J as EntityId, K as JsonObject, L as projectEntityTimeline, Lt as PartAggregation, M as EntityTimelineTrackRole, Mt as effectiveVideoClipDurationMs, N as ResolvedEntityClipPlacement, Nt as speedOf, O as generatePartId, Ot as VideoDocumentValidationIssueCode, P as ResolvedEntityTimelineLayout, Pt as Attachment, Q as buildSpeechHostMap, R as EntityTimelineProjectionError, Rt as SpeedShift, S as SemanticOpKind, St as Track, T as SnapshotReadable, Tt as VideoClipPart, U as CaptionStyleFields, V as RelationRow, Vt as TrackItem$1, W as ScriptTextSegment, X as DerivedItemPosition, Y as buildInitialVideoDocument, Z as SpeechHostMap, _ as SemanticOpName, _t as DEFAULT_UNIT_TIME_MS, a as PlainMemoryAdapter, at as ensureLaneTrack, b as ImplementedSemanticOpKind, bt as SpeechPart, c as MirrorVideoDocumentAdapter, ct as solveVideoDocument, d as createMirrorVideoDocumentAdapter, dt as VideoDocumentDraft, et as fromVideoDocument, f as CommitOptions, ft as VideoDocumentMirrorSchema, g as SemanticOpInput, gt as CaptionPart, h as SemanticEditor, ht as CaptionDisplayCue, i as JournalEntry, it as SolvedVideoDocument, j as validateVideoDocument, jt as VideoDraftPartUnion, k as VideoDocumentValidationError, kt as VideoDraft, l as MirrorVideoDocumentOptions, lt as TrackDraft, m as SemanticDocumentAdapter, mt as BgmPart, n as videoDocumentSchema, nt as LANE_KINDS_IN_STACK_ORDER, o as PlainMemoryAdapterOptions, ot as findLaneTrack, p as OpActor, pt as videoDocumentMirrorSchema, q as JsonValue, r as readVideoDocumentFromDraft, rt as LaneKind, s as createPlainMemoryAdapter, st as laneTrackId, t as partUnionSchema, tt as toVideoDocument, u as createMirrorVideoDocument, ut as TrackItemDraft, v as TransactAudit, vt as PartKind, w as SchemaValidator, wt as TrackItemTimePosition, x as PlannedSemanticOpKind, xt as Timeline, y as IMPLEMENTED_SEMANTIC_OP_KINDS, yt as PartUnion, z as EntityRelationRows, zt as Timeline$1 } from "./index-CcIoMxs1.js";
 import { LoroDoc, PeerID } from "loro-crdt";
 import { DocState } from "@mengine/sync";
 import { BaseDocStorage, Connection, DocDiff, DocPushReceipt, DocSnapshotRecord, DocStorage, DocStorageOptions, DocUpdate, DocUpdateRecord } from "@mengine/storage";
@@ -291,7 +291,7 @@ interface AudioMediaAssetFact {
 interface VoiceoverMediaAssetFact {
   /** Stable external speech result id, independent of the placed Clip id. */
   readonly assetId: string;
-  readonly kind: 'voiceover';
+  readonly kind: 'voiceover-recording';
   readonly durationMs: number;
   readonly storageKey: string;
   /**
@@ -305,22 +305,23 @@ interface VoiceoverMediaAssetFact {
 }
 /** Facts resolved from media storage. A trim window never substitutes for intrinsic duration. */
 type MediaAssetFact = ImageMediaAssetFact | VideoMediaAssetFact | AudioMediaAssetFact | VoiceoverMediaAssetFact;
+/** Where a Clip starts: in flow by order, or at a stated start on its Track or inside its host. */
 type ClipPlacement = {
   readonly kind: 'sequential';
   readonly order: number;
 } | {
   readonly kind: 'absolute';
-  readonly targetRange: SequenceRange<number>;
+  readonly startMs: number;
 } | {
   readonly kind: 'anchored';
   readonly hostClipEntityId: string;
-  readonly anchorOffset: number;
+  readonly startMs: number;
 };
 interface InsertPlacedClipInput {
   readonly trackEntityId: string;
   readonly contentEntityId: string;
-  readonly sourceRange: SequenceRange<number>;
-  readonly duration: SequenceDuration<number>;
+  readonly inMs: number;
+  readonly outMs: number;
   readonly placement: ClipPlacement;
   readonly clipPayload?: JsonObject;
   /** Stable caller-owned placement identity, when one already exists outside the graph. */
@@ -374,31 +375,34 @@ type VoiceoverTakeInput = {
 } & ({
   readonly placement: ClipPlacement;
   readonly hostClipEntityId?: never;
-  readonly anchorOffset?: never;
+  readonly startMs?: never;
 } | {
   readonly placement?: never;
   readonly hostClipEntityId: string;
-  readonly anchorOffset: number;
+  readonly startMs: number;
 });
 type VisualMediaAssetFact = ImageMediaAssetFact | VideoMediaAssetFact;
 interface InsertMediaClipInput {
   readonly timelineEntityId: string;
   readonly clipEntityId?: string;
   readonly media: VisualMediaAssetFact;
-  /** Source/display window in whole milliseconds. Images use this as their finite display span. */
-  readonly sourceRange: SequenceRange<number>;
+  /** Window on the source, whole milliseconds. An Image uses it as its finite display span. */
+  readonly inMs: number;
+  readonly outMs: number;
   readonly placement: ClipPlacement;
   readonly volume?: number;
 }
 interface ReplaceMediaClipInput {
   readonly clipEntityId: string;
   readonly media: VisualMediaAssetFact;
-  readonly sourceRange: SequenceRange<number>;
+  readonly inMs: number;
+  readonly outMs: number;
 }
 interface ReplacementMediaClipInput {
   readonly clipEntityId?: string;
   readonly media: VisualMediaAssetFact;
-  readonly sourceRange: SequenceRange<number>;
+  readonly inMs: number;
+  readonly outMs: number;
   readonly volume?: number;
 }
 type MediaClipInsertion = {
@@ -435,11 +439,13 @@ interface LinearClipSpeed {
 }
 interface SetClipSpeedInput {
   readonly clipEntityId: string;
-  readonly timeRemapping: LinearClipSpeed | null;
+  /** Linear speed; null restores the source's own pace. */
+  readonly rate: number | null;
 }
 interface TrimClipInput {
   readonly clipEntityId: string;
-  readonly sourceRange: SequenceRange<number>;
+  readonly inMs: number;
+  readonly outMs: number;
 }
 interface VoiceoverTakeResult {
   readonly voiceoverClipEntityId: string;
@@ -497,19 +503,21 @@ interface InsertClipInput {
   readonly trackEntityId: string;
   /** Existing Sequence media Entity id. Asset ids and URLs are not content ids. */
   readonly contentEntityId: string;
-  readonly sourceRange: SequenceRange<number>;
-  readonly duration: SequenceDuration<number>;
-  readonly targetRange?: SequenceRange<number>;
+  readonly inMs: number;
+  readonly outMs: number;
+  readonly startMs?: number;
+  /** Where among its Track's Clips it lands; appended when omitted. */
+  readonly order?: number;
   readonly clipPayload?: JsonObject;
 }
 interface UpdateClipMarkerInput {
   readonly clipEntityId: string;
-  readonly sourceRange?: SequenceRange<number>;
-  /** Passing `undefined` explicitly removes the optional target range. */
-  readonly targetRange?: SequenceRange<number> | undefined;
-  readonly duration?: SequenceDuration<number>;
-  /** Passing `undefined` explicitly removes the optional remapping value. */
-  readonly timeRemapping?: JsonValue | undefined;
+  readonly inMs?: number;
+  readonly outMs?: number;
+  /** Passing `undefined` explicitly removes the optional start. */
+  readonly startMs?: number | undefined;
+  /** Passing `undefined` explicitly removes the optional rate. */
+  readonly rate?: number | undefined;
 }
 interface MoveClipInput {
   readonly clipEntityId: string;
@@ -519,10 +527,10 @@ interface ReplaceClipContentInput {
   readonly clipEntityId: string;
   /** Existing Sequence media Entity id. Asset ids and URLs are not content ids. */
   readonly contentEntityId: string;
-  readonly sourceRange: SequenceRange<number>;
-  readonly duration: SequenceDuration<number>;
-  readonly targetRange?: SequenceRange<number>;
-  readonly timeRemapping?: JsonValue;
+  readonly inMs: number;
+  readonly outMs: number;
+  readonly startMs?: number;
+  readonly rate?: number;
 }
 interface DeleteClipInput {
   readonly clipEntityId: string;