@mengine/medeo-client 1.2.1-alpha.7 → 1.2.1-alpha.9

package/dist/{index-InEWX9rk.d.ts → index-CMa6ZCtX.d.ts}

@@ -459,8 +459,8 @@ declare const setVideoClipSpeedShiftInputSchema: z.ZodObject<{
     clip_id: z.ZodString;
     speed_shift: z.ZodNullable<z.ZodObject<{
       category: z.ZodEnum<{
-        curve: "curve";
         linear: "linear";
+        curve: "curve";
       }>;
       mode: z.ZodString;
       config: z.ZodUnion<readonly [z.ZodObject<{
@@ -507,8 +507,8 @@ declare const speechIdsSchema: z.ZodArray<z.ZodString>;
  */
 declare const speedShiftSchema: z.ZodObject<{
   category: z.ZodEnum<{
-    curve: "curve";
     linear: "linear";
+    curve: "curve";
   }>;
   mode: z.ZodString;
   config: z.ZodUnion<readonly [z.ZodObject<{

package/dist/{index-BO2fSUKi.d.ts → index-CbuWTReu.d.ts}

@@ -1,4 +1,4 @@
-import { A as MoveVideoClipsInput, J as ChangeSpeechScriptInput, K as DeleteBgmInput, N as MoveVideoClipsByAnchorInput, O as ReplaceVideoClipContentInput, Q as AdjustVideoClipVolumeInput, R as MoveSpeechesInput, S as SetBgmInput, T as ReplaceVideoClipSequenceInput, V as DeleteVideoClipsInput, W as DeleteSpeechesInput, Y as ChangeSpeechVoiceInput, b as SetCaptionStyleInput, ct as AddSpeechesInput, et as AdjustVideoClipDurationInput, g as SetVideoClipSpeedShiftInput, it as AdjustBgmVolumeInput, nt as AdjustSpeechVolumeInput, ot as AddVideoClipsInput, v as SetCaptionVisibilityInput } from "./index-InEWX9rk.js";
+import { A as MoveVideoClipsInput, J as ChangeSpeechScriptInput, K as DeleteBgmInput, N as MoveVideoClipsByAnchorInput, O as ReplaceVideoClipContentInput, Q as AdjustVideoClipVolumeInput, R as MoveSpeechesInput, S as SetBgmInput, T as ReplaceVideoClipSequenceInput, V as DeleteVideoClipsInput, W as DeleteSpeechesInput, Y as ChangeSpeechVoiceInput, b as SetCaptionStyleInput, ct as AddSpeechesInput, et as AdjustVideoClipDurationInput, g as SetVideoClipSpeedShiftInput, it as AdjustBgmVolumeInput, nt as AdjustSpeechVolumeInput, ot as AddVideoClipsInput, v as SetCaptionVisibilityInput } from "./index-CMa6ZCtX.js";
 import { InferInputType } from "loro-mirror";
 import { z } from "zod";
 import { LoroDoc, PeerID } from "loro-crdt";
@@ -30,10 +30,10 @@ import { LoroDoc, PeerID } from "loro-crdt";
  * @enum
  */
 declare const PartKind$1: {
-  readonly BGM: 'bgm';
-  readonly CAPTION: 'caption';
-  readonly SPEECH: 'speech';
-  readonly VIDEO_CLIP: 'video_clip';
+  readonly BGM: "bgm";
+  readonly CAPTION: "caption";
+  readonly SPEECH: "speech";
+  readonly VIDEO_CLIP: "video_clip";
 };
 /**
  * @public
@@ -145,8 +145,8 @@ interface CaptionPart$1 {
  * @enum
  */
 declare const AspectRatio: {
-  readonly RATIO_16_9: '16:9';
-  readonly RATIO_9_16: '9:16';
+  readonly RATIO_16_9: "16:9";
+  readonly RATIO_9_16: "9:16";
 };
 /**
  * @public
@@ -157,10 +157,10 @@ type AspectRatio = (typeof AspectRatio)[keyof typeof AspectRatio];
  * @enum
  */
 declare const AssetSource: {
-  readonly AI_IMAGES: 'ai_images';
-  readonly AI_VIDEOS: 'ai_videos';
-  readonly MY_UPLOADED_ASSETS: 'my_uploaded_assets';
-  readonly STOCK_VIDEOS: 'stock_videos';
+  readonly AI_IMAGES: "ai_images";
+  readonly AI_VIDEOS: "ai_videos";
+  readonly MY_UPLOADED_ASSETS: "my_uploaded_assets";
+  readonly STOCK_VIDEOS: "stock_videos";
 };
 /**
  * @public
@@ -254,11 +254,11 @@ declare const SpeedShiftCategory: {
   /**
    * Variable speed controlled by Bezier keyframes
    */
-  readonly CURVE: 'curve';
+  readonly CURVE: "curve";
   /**
    * Constant speed multiplier across the entire clip
    */
-  readonly LINEAR: 'linear';
+  readonly LINEAR: "linear";
 };
 /**
  * @public
@@ -442,8 +442,10 @@ interface VideoDraft$1 {
 }
 //#endregion
 //#region src/document/types.d.ts
-declare const VIDEO_DOCUMENT_SCHEMA_VERSION: 'video-document/v0';
-type VideoDocumentSchemaVersion = typeof VIDEO_DOCUMENT_SCHEMA_VERSION;
+declare const VIDEO_DOCUMENT_SCHEMA_VERSION: "video-document/v0";
+/** A server-derived compatibility view, never an editor write authority. */
+declare const ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION: "video-document/entity-projection-v1";
+type VideoDocumentSchemaVersion = typeof VIDEO_DOCUMENT_SCHEMA_VERSION | typeof ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION;
 type PartKind = 'video_clip' | 'speech' | 'caption' | 'bgm';
 /**
  * Project-level creation settings. Mirrors the IDL, but keeps the two fields the
@@ -672,6 +674,7 @@ interface VideoDocumentMeta {
   thumbnail_storage_key: VideoDraft['thumbnail_storage_key'];
   chat_session_id: VideoDraft['chat_session_id'];
   video_creation_settings: VideoDraft['video_creation_settings'];
+  /** Legacy imported version for v0; committed Entity revision for entity-projection-v1. */
   version: VideoDraft['version'];
 }
 /**
@@ -832,6 +835,143 @@ interface InitialDocumentFacts {
  */
 declare function buildInitialVideoDocument(facts: InitialDocumentFacts): VideoDocument;
 //#endregion
+//#region ../medeo-dsl/src/ids.d.ts
+declare const entityIdBrand: unique symbol;
+declare const relationIdBrand: unique symbol;
+type EntityId = string & {
+  readonly [entityIdBrand]: 'EntityId';
+};
+type RelationId = string & {
+  readonly [relationIdBrand]: 'RelationId';
+};
+//#endregion
+//#region ../medeo-dsl/src/entities.d.ts
+type KnownEntityKind = 'axvideo' | 'timeline' | 'track' | 'clip' | 'asset' | 'video' | 'audio' | 'voice' | 'image' | 'sequence-marker' | 'viewport' | 'audio-script' | 'phonetic-script' | 'caption';
+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;
+};
+interface VoiceDescriptor {
+  readonly system: 'voice-library';
+  readonly key: string;
+  readonly name?: string;
+}
+interface CaptionFontDescriptor {
+  readonly system: 'font-library';
+  readonly key: string;
+}
+interface CaptionStyleFields {
+  readonly font?: CaptionFontDescriptor;
+  readonly fontSize?: number;
+  readonly fontColor?: string;
+  readonly fontWeight?: number;
+  readonly entranceAnimation?: string;
+  readonly entranceAnimationDurationMs?: number;
+  readonly strokeColor?: string;
+  readonly strokeWidth?: number;
+  readonly positionX?: number;
+  readonly positionY?: number;
+}
+//#endregion
+//#region ../medeo-dsl/src/json-values.d.ts
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonObject | readonly JsonValue[];
+type JsonObject = {
+  readonly [key: string]: JsonValue;
+};
+//#endregion
+//#region ../medeo-dsl/src/relations.d.ts
+type KnownRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'physical-asset' | 'generated' | 'phonetic-script-provenance' | 'caption-provenance' | 'caption-alignment' | 'clip-anchor' | 'audio-script-render';
+type RelationKind = KnownRelationKind | (string & {});
+type RelationTrace = JsonObject;
+/**
+ * Authoritative persisted relation value.
+ *
+ * A kind may assign semantic roles to endpoint 0 and endpoint 1. Callers and
+ * 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> {
+  readonly relationId: RelationId;
+  readonly endpoint0EntityId: EntityId;
+  readonly endpoint1EntityId: EntityId;
+  readonly relationKind: K;
+  readonly metadata: Metadata;
+  readonly trace: RelationTrace;
+}
+//#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> {
+  readonly entityId: EntityId;
+  readonly entityKind: K;
+  readonly payload: JsonObject;
+}
+/** Complete persistence value for an entity set and its authoritative relations. */
+interface EntityRelationRows {
+  readonly entities: readonly EntityRow[];
+  readonly relations: readonly RelationRow[];
+}
+//#endregion
+//#region src/document/entity-projection-values.d.ts
+/** A graph cannot be represented faithfully by the compatibility reader. */
+declare class EntityTimelineProjectionError extends Error {
+  constructor(message: string);
+}
+//#endregion
+//#region src/document/entity-projection.d.ts
+/**
+ * One-way compatibility view over the Entity graph. A legacy part is never
+ * consulted as an editing fact. Peer IDs appear only in this derived read
+ * contract, reconstructed from relations; they are not stored in payloads.
+ */
+declare function projectEntityTimeline(rows: EntityRelationRows, meta: VideoDocumentMeta): VideoDocument;
+//#endregion
+//#region src/document/entity-timeline-layout.d.ts
+type EntityTimelineTrackRole = 'video_clip' | 'speech' | 'caption' | 'bgm';
+interface ResolvedEntityClipPlacement {
+  readonly clipEntityId: string;
+  readonly markerEntityId: string;
+  readonly contentEntityId: string;
+  readonly trackEntityId: string;
+  readonly start: number;
+  readonly duration: number;
+  readonly mode: 'sequential' | 'absolute' | 'anchored';
+  readonly anchorClipEntityId?: string;
+  readonly anchorOffset?: number;
+}
+interface ResolvedEntityTrack {
+  readonly entityId: string;
+  readonly role: EntityTimelineTrackRole;
+  readonly order: number;
+  readonly hidden: boolean;
+  readonly clips: readonly ResolvedEntityClipPlacement[];
+}
+interface ResolvedEntityTimelineLayout {
+  readonly tracks: readonly ResolvedEntityTrack[];
+  readonly clips: ReadonlyMap<string, ResolvedEntityClipPlacement>;
+  /** Background music fills this duration; it never extends the timeline. */
+  readonly durationMs: number;
+}
+/**
+ * Resolve only entity-owned placement facts. This does not choose new anchors,
+ * manufacture clips, or mutate a graph while reading. Write-side operations
+ * must express any detach/reparent/overlap decision in their entity plan.
+ */
+declare function resolveEntityTimelineLayout(rows: EntityRelationRows): ResolvedEntityTimelineLayout;
+//#endregion
 //#region src/document/validation.d.ts
 /**
  * Business-level schema guard for `VideoDocument` (RFC 03 §9). It is the gate
@@ -1356,6 +1496,8 @@ declare class MirrorVideoDocumentAdapter implements SemanticDocumentAdapter {
 declare function createMirrorVideoDocument(document: VideoDocument, options?: MirrorVideoDocumentOptions): LoroDoc;
 /** Build a `MirrorVideoDocumentAdapter` over a fresh doc seeded with `document`. */
 declare function createMirrorVideoDocumentAdapter(document: VideoDocument, options?: MirrorVideoDocumentOptions): MirrorVideoDocumentAdapter;
+/** Host-only replacement of a derived view, retaining the existing Loro history. */
+declare function applyEntityTimelineProjection(doc: LoroDoc, projection: VideoDocument, entityRevision: number): Uint8Array;
 /** Write a whole `VideoDocument` into a draft (seed a fresh doc / plain-memory state). */
 declare function writeVideoDocumentToDraft(draft: VideoDocumentDraft, document: VideoDocument): void;
 //#endregion
@@ -1491,7 +1633,10 @@ declare const partUnionSchema: z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$loose>]>;
 declare const videoDocumentSchema: z.ZodObject<{
   meta: z.ZodObject<{
-    schema_version: z.ZodLiteral<"video-document/v0">;
+    schema_version: z.ZodEnum<{
+      "video-document/v0": "video-document/v0";
+      "video-document/entity-projection-v1": "video-document/entity-projection-v1";
+    }>;
     draft_id: z.ZodOptional<z.ZodString>;
     project_id: z.ZodOptional<z.ZodString>;
     owner_id: z.ZodOptional<z.ZodString>;
@@ -1506,9 +1651,9 @@ declare const videoDocumentSchema: z.ZodObject<{
   tracks: z.ZodOptional<z.ZodArray<z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     parts_kind: z.ZodOptional<z.ZodEnum<{
-      bgm: "bgm";
-      caption: "caption";
       speech: "speech";
+      caption: "caption";
+      bgm: "bgm";
       video_clip: "video_clip";
     }>>;
     is_hidden: z.ZodOptional<z.ZodBoolean>;
@@ -1591,4 +1736,4 @@ declare const videoDocumentSchema: z.ZodObject<{
   }, z.core.$loose>]>>>;
 }, z.core.$loose>;
 //#endregion
-export { Track as $, TrackDraft as A, DerivedItemPosition as B, SemanticOpKind as C, ValidationError as D, SnapshotReadable as E, VideoDocumentValidationError as F, toVideoDocument as G, buildSpeechHostMap as H, assertValidVideoDocument as I, DEFAULT_UNIT_TIME_MS as J, BgmPart as K, validateVideoDocument as L, VideoDocumentDraft as M, VideoDocumentMirrorSchema as N, PartIdFactory as O, videoDocumentMirrorSchema as P, Timeline as Q, InitialDocumentFacts as R, PlannedSemanticOpKind as S, SchemaValidator as T, derivePositionFromAbs as U, SpeechHostMap as V, fromVideoDocument as W, PartUnion as X, PartKind as Y, SpeechPart as Z, SemanticOpInput as _, Timeline$1 as _t, PlainMemoryAdapter as a, VideoDocumentSchemaVersion as at, IMPLEMENTED_SEMANTIC_OP_KINDS as b, MirrorVideoDocumentAdapter as c, VideoDraft as ct, createMirrorVideoDocumentAdapter as d, speedOf as dt, TrackItem as et, writeVideoDocumentToDraft as f, Attachment as ft, SemanticEditor as g, SpeedShift as gt, SemanticDocumentAdapter as h, PartAggregation as ht, JournalEntry as i, VideoDocument as it, TrackItemDraft as j, generatePartId as k, MirrorVideoDocumentOptions as l, VideoDraftPartUnion as lt, OpActor as m, CaptionStyle as mt, videoDocumentSchema as n, VIDEO_DOCUMENT_SCHEMA_VERSION as nt, PlainMemoryAdapterOptions as o, VideoDocumentValidationIssue as ot, CommitOptions as p, CaptionPart$1 as pt, CaptionPart as q, readVideoDocumentFromDraft as r, VideoClipPart as rt, createPlainMemoryAdapter as s, VideoDocumentValidationIssueCode as st, partUnionSchema as t, TrackItemTimePosition as tt, createMirrorVideoDocument as u, effectiveVideoClipDurationMs as ut, SemanticOpName as v, Track$1 as vt, isImplementedSemanticOpKind as w, ImplementedSemanticOpKind as x, TransactAudit as y, TrackItem$1 as yt, buildInitialVideoDocument as z };
+export { EntityId as $, generatePartId as A, CaptionPart$1 as At, ResolvedEntityClipPlacement as B, PlannedSemanticOpKind as C, VideoDocumentValidationIssue as Ct, SnapshotReadable as D, effectiveVideoClipDurationMs as Dt, SchemaValidator as E, VideoDraftPartUnion as Et, videoDocumentMirrorSchema as F, Track$1 as Ft, EntityTimelineProjectionError as G, ResolvedEntityTrack as H, VideoDocumentValidationError as I, TrackItem$1 as It, JsonValue as J, EntityRelationRows as K, assertValidVideoDocument as L, TrackItemDraft as M, PartAggregation as Mt, VideoDocumentDraft as N, SpeedShift as Nt, ValidationError as O, speedOf as Ot, VideoDocumentMirrorSchema as P, Timeline$1 as Pt, VoiceDescriptor as Q, validateVideoDocument as R, ImplementedSemanticOpKind as S, VideoDocumentSchemaVersion as St, isImplementedSemanticOpKind as T, VideoDraft as Tt, resolveEntityTimelineLayout as U, ResolvedEntityTimelineLayout as V, projectEntityTimeline as W, SequenceDuration as X, CaptionStyleFields as Y, SequenceRange as Z, SemanticEditor as _, TrackItem as _t, PlainMemoryAdapter as a, derivePositionFromAbs as at, TransactAudit as b, VideoClipPart as bt, MirrorVideoDocumentAdapter as c, BgmPart as ct, createMirrorVideoDocument as d, ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION as dt, InitialDocumentFacts as et, createMirrorVideoDocumentAdapter as f, PartKind as ft, SemanticDocumentAdapter as g, Track as gt, OpActor as h, Timeline as ht, JournalEntry as i, buildSpeechHostMap as it, TrackDraft as j, CaptionStyle as jt, PartIdFactory as k, Attachment as kt, MirrorVideoDocumentOptions as l, CaptionPart as lt, CommitOptions as m, SpeechPart as mt, videoDocumentSchema as n, DerivedItemPosition as nt, PlainMemoryAdapterOptions as o, fromVideoDocument as ot, writeVideoDocumentToDraft as p, PartUnion as pt, JsonObject as q, readVideoDocumentFromDraft as r, SpeechHostMap as rt, createPlainMemoryAdapter as s, toVideoDocument as st, partUnionSchema as t, buildInitialVideoDocument as tt, applyEntityTimelineProjection as u, DEFAULT_UNIT_TIME_MS as ut, SemanticOpInput as v, TrackItemTimePosition as vt, SemanticOpKind as w, VideoDocumentValidationIssueCode as wt, IMPLEMENTED_SEMANTIC_OP_KINDS as x, VideoDocument as xt, SemanticOpName as y, VIDEO_DOCUMENT_SCHEMA_VERSION as yt, EntityTimelineTrackRole as z };