@mengine/medeo-client 1.2.1-alpha.0 → 1.2.1-alpha.10

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-PAM9x_fu.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 { VoiceDescriptor as $, generatePartId as A, Attachment as At, ResolvedEntityClipPlacement as B, PlannedSemanticOpKind as C, VideoDocumentSchemaVersion as Ct, SnapshotReadable as D, VideoDraftPartUnion as Dt, SchemaValidator as E, VideoDraft as Et, videoDocumentMirrorSchema as F, Timeline$1 as Ft, EntityTimelineProjectionError as G, ResolvedEntityTrack as H, VideoDocumentValidationError as I, Track$1 as It, JsonObject as J, EntityRelationRows as K, assertValidVideoDocument as L, TrackItem$1 as Lt, TrackItemDraft as M, CaptionStyle as Mt, VideoDocumentDraft as N, PartAggregation as Nt, ValidationError as O, effectiveVideoClipDurationMs as Ot, VideoDocumentMirrorSchema as P, SpeedShift as Pt, SequenceRange as Q, validateVideoDocument as R, ImplementedSemanticOpKind as S, VideoDocument as St, isImplementedSemanticOpKind as T, VideoDocumentValidationIssueCode as Tt, resolveEntityTimelineLayout as U, ResolvedEntityTimelineLayout as V, projectEntityTimeline as W, CaptionStyleFields as X, JsonValue as Y, SequenceDuration as Z, SemanticEditor as _, Track as _t, PlainMemoryAdapter as a, buildSpeechHostMap as at, TransactAudit as b, VIDEO_DOCUMENT_SCHEMA_VERSION as bt, MirrorVideoDocumentAdapter as c, toVideoDocument as ct, createMirrorVideoDocument as d, DEFAULT_UNIT_TIME_MS as dt, EntityId as et, createMirrorVideoDocumentAdapter as f, ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION as ft, SemanticDocumentAdapter as g, Timeline as gt, OpActor as h, SpeechPart as ht, JournalEntry as i, SpeechHostMap as it, TrackDraft as j, CaptionPart$1 as jt, PartIdFactory as k, speedOf as kt, MirrorVideoDocumentOptions as l, BgmPart as lt, CommitOptions as m, PartUnion as mt, videoDocumentSchema as n, buildInitialVideoDocument as nt, PlainMemoryAdapterOptions as o, derivePositionFromAbs as ot, writeVideoDocumentToDraft as p, PartKind as pt, EntityRow as q, readVideoDocumentFromDraft as r, DerivedItemPosition as rt, createPlainMemoryAdapter as s, fromVideoDocument as st, partUnionSchema as t, InitialDocumentFacts as tt, applyEntityTimelineProjection as u, CaptionPart as ut, SemanticOpInput as v, TrackItem as vt, SemanticOpKind as w, VideoDocumentValidationIssue as wt, IMPLEMENTED_SEMANTIC_OP_KINDS as x, VideoClipPart as xt, SemanticOpName as y, TrackItemTimePosition as yt, EntityTimelineTrackRole as z };