@mengine/medeo-client 2.0.1-alpha.29 → 2.0.1-alpha.30

package/dist/{document-B3RLmTzA.js → document-e4Y1QNMu.js}

@@ -4959,4 +4959,4 @@ function createPlainMemoryAdapter(document, options) {
 	return new PlainMemoryAdapter(document, options);
 }
 //#endregion
-export { fromVideoDocument as $, resolveEntityTimelineLayout as A, base64ToBytes as At, assembleScriptText as B, canonicalJson as C, safeDurationMs as Ct, resolveFieldPath as D, partUnionToDraft as Dt, assertFieldChanges as E, speedOf as Et, relationsTo as F, isJsonObject as G, selectAudioScriptSegment as H, ScriptCompositionError as I, hasSequence as J, createEntityId as K, assembleCaptionContent as L, validateEntityRelationTransition as M, decodeEntityRelationRows as N, projectEntityTimeline as O, recordEntries as Ot, relationsFrom as P, derivePositionFromAbs as Q, assembleEntityContent as R, scriptSourceAssetOf as S, partDurationMs as St, applyFieldChanges as T, effectiveVideoClipDurationMs as Tt, updateEntityFields as U, findComposedAudioScript as V, variantBaseEntityIds as W, buildInitialVideoDocument as X, isMediaAssetVariantKind as Y, buildSpeechHostMap as Z, audioScriptAssetHash as _, resolveAllSpeechOverlaps as _t, createMirrorVideoDocument as a, videoDocumentSchema as at, phoneticScriptAssetHash as b, TIMELINE_SKELETON_DURATION_MS as bt, DocumentMutationGuard as c, findLaneTrack as ct, LoroEntityDraft as d, solveVideoDocument as dt, toVideoDocument as et, readEntityDocument as f, cascadeAfterVideoClipChanges as ft, audioScriptAssetFields as g, recalculateTimelineDuration as gt, audioScriptAssetContent as h, reassignSpeechesToVideoClipsByTime as ht, MirrorVideoDocumentAdapter as i, partUnionSchema as it, EntityTimelineProjectionError as j, bytesToBase64 as jt, EntityProjectionGraph as k, videoDocumentMirrorSchema as kt, LORO_ENTITY_SCHEMA as l, hasResolvedPlacement as lt, entityOrderGroups as m, fillMainTrackTimeGaps as mt, createPlainMemoryAdapter as n, assertValidVideoDocument as nt, createMirrorVideoDocumentAdapter as o, LANE_KINDS_IN_STACK_ORDER as ot, readEntityRelationRecords as p, arrangeMainTrackSeamlessly as pt, createRelationId as q, generatePartId as r, validateVideoDocument as rt, readVideoDocumentFromDraft as s, ensureLaneTrack as st, PlainMemoryAdapter as t, VideoDocumentValidationError as tt, LoroEntityDocument as u, laneTrackId as ut, audioScriptAssetOf as v, resolveSpeechOverlapByShiftingVideos as vt, equalJson as w, DEFAULT_UNIT_TIME_MS as wt, phoneticScriptAssetOf as x, isEmptyVideoClip as xt, phoneticScriptAssetContent as y, syncAggregatedClipsTimePosition as yt, assemblePhoneticScriptContent as z };
+export { derivePositionFromAbs as $, resolveEntityTimelineLayout as A, videoDocumentMirrorSchema as At, assemblePhoneticScriptContent as B, canonicalJson as C, partDurationMs as Ct, resolveFieldPath as D, speedOf as Dt, assertFieldChanges as E, effectiveVideoClipDurationMs as Et, relationsTo as F, variantBaseEntityIds as G, findComposedAudioScript as H, scriptContentHash as I, createRelationId as J, isJsonObject as K, ScriptCompositionError as L, validateEntityRelationTransition as M, bytesToBase64 as Mt, decodeEntityRelationRows as N, projectEntityTimeline as O, partUnionToDraft as Ot, relationsFrom as P, buildSpeechHostMap as Q, assembleCaptionContent as R, scriptSourceAssetOf as S, isEmptyVideoClip as St, applyFieldChanges as T, DEFAULT_UNIT_TIME_MS as Tt, selectAudioScriptSegment as U, assembleScriptText as V, updateEntityFields as W, isMediaAssetVariantKind as X, hasSequence as Y, buildInitialVideoDocument as Z, audioScriptAssetHash as _, recalculateTimelineDuration as _t, createMirrorVideoDocument as a, partUnionSchema as at, phoneticScriptAssetHash as b, syncAggregatedClipsTimePosition as bt, DocumentMutationGuard as c, ensureLaneTrack as ct, LoroEntityDraft as d, laneTrackId as dt, fromVideoDocument as et, readEntityDocument as f, solveVideoDocument as ft, audioScriptAssetFields as g, reassignSpeechesToVideoClipsByTime as gt, audioScriptAssetContent as h, fillMainTrackTimeGaps as ht, MirrorVideoDocumentAdapter as i, validateVideoDocument as it, EntityTimelineProjectionError as j, base64ToBytes as jt, EntityProjectionGraph as k, recordEntries as kt, LORO_ENTITY_SCHEMA as l, findLaneTrack as lt, entityOrderGroups as m, arrangeMainTrackSeamlessly as mt, createPlainMemoryAdapter as n, VideoDocumentValidationError as nt, createMirrorVideoDocumentAdapter as o, videoDocumentSchema as ot, readEntityRelationRecords as p, cascadeAfterVideoClipChanges as pt, createEntityId as q, generatePartId as r, assertValidVideoDocument as rt, readVideoDocumentFromDraft as s, LANE_KINDS_IN_STACK_ORDER as st, PlainMemoryAdapter as t, toVideoDocument as tt, LoroEntityDocument as u, hasResolvedPlacement as ut, audioScriptAssetOf as v, resolveAllSpeechOverlaps as vt, equalJson as w, safeDurationMs as wt, phoneticScriptAssetOf as x, TIMELINE_SKELETON_DURATION_MS as xt, phoneticScriptAssetContent as y, resolveSpeechOverlapByShiftingVideos as yt, assembleEntityContent as z };

package/dist/index.d.ts

@@ -625,6 +625,47 @@ declare class EntityTimelineEditor {
   private mintRelationId;
 }
 //#endregion
+//#region src/entity-editor/visual-assets-effect.d.ts
+type MediaFact = MediaAssetFact;
+interface VisualAssetsEffectInput {
+  /** Stable command identity. A retried command must reuse it; a new placement must use a new one. */
+  effect_id: string;
+  clips: ReadonlyArray<{
+    media_id: string;
+    media_kind: 'image' | 'video';
+    media_duration_ms: number;
+    storage_key?: string;
+    start_ms?: number;
+    play_in?: number;
+    play_out?: number;
+    volume?: number;
+    lineage?: {
+      generation_job_id: string;
+      sources: ReadonlyArray<MediaFact>;
+      script?: {
+        entity_id: string;
+        segments: ReadonlyArray<{
+          segment_id: string;
+          text: string;
+          language?: string;
+        }>;
+        content_hash: string;
+      };
+    };
+  }>;
+  before_clip_id?: string;
+  after_clip_id?: string;
+}
+/** Read the authoritative timeline receipt, not a media-id heuristic. */
+declare function hasVisualAssetsEffect(rows: EntityRelationRows, effectId: string): boolean;
+/**
+ * Materialize a host-resolved visual command into native Entity/Relation rows.
+ * The result is suitable for one revision-checked `EntityGraphHttpClient.commit`.
+ * This does not fetch Assets or write remotely; callers must supply factual media
+ * and lineage inputs after their own ownership checks.
+ */
+declare function applyVisualAssetsEffect(rows: EntityRelationRows, input: VisualAssetsEffectInput): EntityRelationRows;
+//#endregion
 //#region src/entity-editor/revise-audio-script.d.ts
 interface ReviseAudioScriptInput {
   readonly editId: string;
@@ -1851,4 +1892,4 @@ declare function phoneticScriptAssetHash(rows: EntityRelationRows, entityId: str
 /** The Asset a PhoneticScript was written out to, read from the graph. */
 declare function phoneticScriptAssetOf(rows: EntityRelationRows, entityId: string): EntityRow | undefined;
 //#endregion
-export { type Aggregation, ApplyEntityRowsOptions, type AssembledCaptionContent, type AssembledPhoneticScriptContent, type Attachment, type AudioMediaAssetFact, type BgmPart, type CaptionContentInput, type CaptionDisplayCue, type CaptionPart, type CaptionSegmentSelection, type CaptionStyle, type ClipEntityId, type ClipPlacement, type CommitOptions, DEFAULT_UNIT_TIME_MS, type DeleteBgmInput, type DeleteClipInput, type DeleteClipTreeInput, type DeleteVoiceoverInput, type DerivedItemPosition, type DocStorageLike, type DocVersionMark, type DocumentAudioScript, type DocumentAudioScriptState, type EditorFoundation, EntityDocumentState, type EntityGraphCommitOptions, EntityGraphHttpClient, EntityGraphRevisionConflictError, type EntityGraphRevisionConflictPayload, type EntityGraphState, EntityRelationRecord, EntityTimelineEditor, type EntityTimelineIdFactory, EntityTimelineProjectionError, type EntityTimelineTrackRole, type FieldChange, type FieldPath, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImageMediaAssetFact, type ImplementedSemanticOpKind, type ImportedMediaAsset, type InsertCaptionClipInput, type InsertClipInput, type InsertMediaClipInput, type InsertMediaClipsInput, type InsertPlacedClipInput, type JournalEntry, LANE_KINDS_IN_STACK_ORDER, LORO_ENTITY_SCHEMA, type LaneKind, type LinearClipSpeed, LoroEntityDocument, LoroEntityDraft, type MainClipRange, type MakeEmptyPart, ManualSyncDoc, type ManualSyncDocOptions, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type MediaAssetFact, type MediaClipInsertion, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocSyncState, type MengineDocumentVersion, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUndoState, type MengineUpdateMeta, MirrorVideoDocumentAdapter, type MirrorVideoDocumentOptions, type MoveClipInput, type MoveClipsToStartsInput, type MoveSequentialClipsInput, type MoveVoiceoverInput, type OpActor, type PartAggregation, type PartIdFactory, type PartKind, type PartUnion, type PatchCaptionStyleInput, PlainMemoryAdapter, type PlainMemoryAdapterOptions, type PlannedSemanticOpKind, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type ReplaceClipContentInput, type ReplaceMediaClipInput, type ReplaceSequentialClipsInput, type ReplacementMediaClipInput, type ResolvedEntityClipPlacement, type ResolvedEntityTimelineLayout, type ResolvedEntityTrack, type ReviseAudioScriptInput, type ReviseAudioScriptResult, SchemaValidator, ScriptCompositionError, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SequentialClipAnchor, type SetBgmInput, type SetCaptionVisibilityInput, type SetClipPlacementInput, type SetClipSpeedInput, type SetClipVolumeInput, type SnapshotReadable, type SolvedVideoDocument, type SpeechHostMap, type SpeechPart, type SpeedShift, TIMELINE_SKELETON_DURATION_MS, type Timeline, type TimelineDoc, type TimelineItem, type Track, type TrackDraft, type TrackItem, type TrackItemDraft, type TrackItemTimePosition, type TransactAudit, type TrimClipInput, type UpdateClipInput, type UpdateClipMarkerInput, ValidationError, type VideoClipPart, type VideoDocument, type VideoDocumentDraft, type VideoDocumentMirrorSchema, VideoDocumentValidationError, type VideoDocumentValidationIssue, type VideoDocumentValidationIssueCode, type VideoDraft, type CaptionPart$1 as VideoDraftCaptionPart, type VideoDraftContent, type VideoDraftPartUnion, type Timeline$1 as VideoDraftTimeline, type Track$1 as VideoDraftTrack, type TrackItem$1 as VideoDraftTrackItem, type VideoMediaAssetFact, type VisualMediaAssetFact, type VoiceoverCaptionFact, type VoiceoverMediaAssetFact, type VoiceoverTakeInput, type VoiceoverTakeResult, type WaitForServerAckOptions, applyEntityRows, applyFieldChanges, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertFieldChanges, assertMediaAssetWritePolicy, assertValidVideoDocument, audioScriptAssetContent, audioScriptAssetFields, audioScriptAssetHash, audioScriptAssetOf, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, compileEntityRows, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateAlpha23EntityDocument, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, phoneticScriptAssetContent, phoneticScriptAssetHash, phoneticScriptAssetOf, prepareCaptionContent, projectEntityTimeline, publishEntityRows, readDocumentAudioScript, readEntityDocument, readEntityRelationRecords, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveFieldPath, resolveSpeechOverlapByShiftingVideos, reviseAudioScript, safeDurationMs, index_d_exports as schemas, scriptSourceAssetOf, selectAudioScriptSegment, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };
+export { type Aggregation, ApplyEntityRowsOptions, type AssembledCaptionContent, type AssembledPhoneticScriptContent, type Attachment, type AudioMediaAssetFact, type BgmPart, type CaptionContentInput, type CaptionDisplayCue, type CaptionPart, type CaptionSegmentSelection, type CaptionStyle, type ClipEntityId, type ClipPlacement, type CommitOptions, DEFAULT_UNIT_TIME_MS, type DeleteBgmInput, type DeleteClipInput, type DeleteClipTreeInput, type DeleteVoiceoverInput, type DerivedItemPosition, type DocStorageLike, type DocVersionMark, type DocumentAudioScript, type DocumentAudioScriptState, type EditorFoundation, EntityDocumentState, type EntityGraphCommitOptions, EntityGraphHttpClient, EntityGraphRevisionConflictError, type EntityGraphRevisionConflictPayload, type EntityGraphState, EntityRelationRecord, EntityTimelineEditor, type EntityTimelineIdFactory, EntityTimelineProjectionError, type EntityTimelineTrackRole, type FieldChange, type FieldPath, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImageMediaAssetFact, type ImplementedSemanticOpKind, type ImportedMediaAsset, type InsertCaptionClipInput, type InsertClipInput, type InsertMediaClipInput, type InsertMediaClipsInput, type InsertPlacedClipInput, type JournalEntry, LANE_KINDS_IN_STACK_ORDER, LORO_ENTITY_SCHEMA, type LaneKind, type LinearClipSpeed, LoroEntityDocument, LoroEntityDraft, type MainClipRange, type MakeEmptyPart, ManualSyncDoc, type ManualSyncDocOptions, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type MediaAssetFact, type MediaClipInsertion, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocSyncState, type MengineDocumentVersion, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUndoState, type MengineUpdateMeta, MirrorVideoDocumentAdapter, type MirrorVideoDocumentOptions, type MoveClipInput, type MoveClipsToStartsInput, type MoveSequentialClipsInput, type MoveVoiceoverInput, type OpActor, type PartAggregation, type PartIdFactory, type PartKind, type PartUnion, type PatchCaptionStyleInput, PlainMemoryAdapter, type PlainMemoryAdapterOptions, type PlannedSemanticOpKind, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type ReplaceClipContentInput, type ReplaceMediaClipInput, type ReplaceSequentialClipsInput, type ReplacementMediaClipInput, type ResolvedEntityClipPlacement, type ResolvedEntityTimelineLayout, type ResolvedEntityTrack, type ReviseAudioScriptInput, type ReviseAudioScriptResult, SchemaValidator, ScriptCompositionError, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SequentialClipAnchor, type SetBgmInput, type SetCaptionVisibilityInput, type SetClipPlacementInput, type SetClipSpeedInput, type SetClipVolumeInput, type SnapshotReadable, type SolvedVideoDocument, type SpeechHostMap, type SpeechPart, type SpeedShift, TIMELINE_SKELETON_DURATION_MS, type Timeline, type TimelineDoc, type TimelineItem, type Track, type TrackDraft, type TrackItem, type TrackItemDraft, type TrackItemTimePosition, type TransactAudit, type TrimClipInput, type UpdateClipInput, type UpdateClipMarkerInput, ValidationError, type VideoClipPart, type VideoDocument, type VideoDocumentDraft, type VideoDocumentMirrorSchema, VideoDocumentValidationError, type VideoDocumentValidationIssue, type VideoDocumentValidationIssueCode, type VideoDraft, type CaptionPart$1 as VideoDraftCaptionPart, type VideoDraftContent, type VideoDraftPartUnion, type Timeline$1 as VideoDraftTimeline, type Track$1 as VideoDraftTrack, type TrackItem$1 as VideoDraftTrackItem, type VideoMediaAssetFact, type VisualAssetsEffectInput, type VisualMediaAssetFact, type VoiceoverCaptionFact, type VoiceoverMediaAssetFact, type VoiceoverTakeInput, type VoiceoverTakeResult, type WaitForServerAckOptions, applyEntityRows, applyFieldChanges, applyVisualAssetsEffect, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertFieldChanges, assertMediaAssetWritePolicy, assertValidVideoDocument, audioScriptAssetContent, audioScriptAssetFields, audioScriptAssetHash, audioScriptAssetOf, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, compileEntityRows, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hasVisualAssetsEffect, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateAlpha23EntityDocument, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, phoneticScriptAssetContent, phoneticScriptAssetHash, phoneticScriptAssetOf, prepareCaptionContent, projectEntityTimeline, publishEntityRows, readDocumentAudioScript, readEntityDocument, readEntityRelationRecords, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveFieldPath, resolveSpeechOverlapByShiftingVideos, reviseAudioScript, safeDurationMs, index_d_exports as schemas, scriptSourceAssetOf, selectAudioScriptSegment, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { $ as fromVideoDocument, A as resolveEntityTimelineLayout, At as base64ToBytes, B as assembleScriptText, C as canonicalJson, Ct as safeDurationMs, D as resolveFieldPath, Dt as partUnionToDraft, E as assertFieldChanges, Et as speedOf, F as relationsTo, G as isJsonObject, H as selectAudioScriptSegment, I as ScriptCompositionError, J as hasSequence, K as createEntityId, L as assembleCaptionContent, M as validateEntityRelationTransition, N as decodeEntityRelationRows, O as projectEntityTimeline, Ot as recordEntries, P as relationsFrom, Q as derivePositionFromAbs, R as assembleEntityContent, S as scriptSourceAssetOf, St as partDurationMs, T as applyFieldChanges, Tt as effectiveVideoClipDurationMs, U as updateEntityFields, V as findComposedAudioScript, W as variantBaseEntityIds, X as buildInitialVideoDocument, Y as isMediaAssetVariantKind, Z as buildSpeechHostMap, _ as audioScriptAssetHash, _t as resolveAllSpeechOverlaps, a as createMirrorVideoDocument, at as videoDocumentSchema, b as phoneticScriptAssetHash, bt as TIMELINE_SKELETON_DURATION_MS, c as DocumentMutationGuard, ct as findLaneTrack, d as LoroEntityDraft, dt as solveVideoDocument, et as toVideoDocument, f as readEntityDocument, ft as cascadeAfterVideoClipChanges, g as audioScriptAssetFields, gt as recalculateTimelineDuration, h as audioScriptAssetContent, ht as reassignSpeechesToVideoClipsByTime, i as MirrorVideoDocumentAdapter, it as partUnionSchema, j as EntityTimelineProjectionError, jt as bytesToBase64, k as EntityProjectionGraph, kt as videoDocumentMirrorSchema, l as LORO_ENTITY_SCHEMA, lt as hasResolvedPlacement, m as entityOrderGroups, mt as fillMainTrackTimeGaps, n as createPlainMemoryAdapter, nt as assertValidVideoDocument, o as createMirrorVideoDocumentAdapter, ot as LANE_KINDS_IN_STACK_ORDER, p as readEntityRelationRecords, pt as arrangeMainTrackSeamlessly, q as createRelationId, r as generatePartId, rt as validateVideoDocument, s as readVideoDocumentFromDraft, st as ensureLaneTrack, t as PlainMemoryAdapter, tt as VideoDocumentValidationError, u as LoroEntityDocument, ut as laneTrackId, v as audioScriptAssetOf, vt as resolveSpeechOverlapByShiftingVideos, w as equalJson, wt as DEFAULT_UNIT_TIME_MS, x as phoneticScriptAssetOf, xt as isEmptyVideoClip, y as phoneticScriptAssetContent, yt as syncAggregatedClipsTimePosition, z as assemblePhoneticScriptContent } from "./document-B3RLmTzA.js";
+import { $ as derivePositionFromAbs, A as resolveEntityTimelineLayout, At as videoDocumentMirrorSchema, B as assemblePhoneticScriptContent, C as canonicalJson, Ct as partDurationMs, D as resolveFieldPath, Dt as speedOf, E as assertFieldChanges, Et as effectiveVideoClipDurationMs, F as relationsTo, G as variantBaseEntityIds, H as findComposedAudioScript, I as scriptContentHash, J as createRelationId, K as isJsonObject, L as ScriptCompositionError, M as validateEntityRelationTransition, Mt as bytesToBase64, N as decodeEntityRelationRows, O as projectEntityTimeline, Ot as partUnionToDraft, P as relationsFrom, Q as buildSpeechHostMap, R as assembleCaptionContent, S as scriptSourceAssetOf, St as isEmptyVideoClip, T as applyFieldChanges, Tt as DEFAULT_UNIT_TIME_MS, U as selectAudioScriptSegment, V as assembleScriptText, W as updateEntityFields, X as isMediaAssetVariantKind, Y as hasSequence, Z as buildInitialVideoDocument, _ as audioScriptAssetHash, _t as recalculateTimelineDuration, a as createMirrorVideoDocument, at as partUnionSchema, b as phoneticScriptAssetHash, bt as syncAggregatedClipsTimePosition, c as DocumentMutationGuard, ct as ensureLaneTrack, d as LoroEntityDraft, dt as laneTrackId, et as fromVideoDocument, f as readEntityDocument, ft as solveVideoDocument, g as audioScriptAssetFields, gt as reassignSpeechesToVideoClipsByTime, h as audioScriptAssetContent, ht as fillMainTrackTimeGaps, i as MirrorVideoDocumentAdapter, it as validateVideoDocument, j as EntityTimelineProjectionError, jt as base64ToBytes, k as EntityProjectionGraph, kt as recordEntries, l as LORO_ENTITY_SCHEMA, lt as findLaneTrack, m as entityOrderGroups, mt as arrangeMainTrackSeamlessly, n as createPlainMemoryAdapter, nt as VideoDocumentValidationError, o as createMirrorVideoDocumentAdapter, ot as videoDocumentSchema, p as readEntityRelationRecords, pt as cascadeAfterVideoClipChanges, q as createEntityId, r as generatePartId, rt as assertValidVideoDocument, s as readVideoDocumentFromDraft, st as LANE_KINDS_IN_STACK_ORDER, t as PlainMemoryAdapter, tt as toVideoDocument, u as LoroEntityDocument, ut as hasResolvedPlacement, v as audioScriptAssetOf, vt as resolveAllSpeechOverlaps, w as equalJson, wt as safeDurationMs, x as phoneticScriptAssetOf, xt as TIMELINE_SKELETON_DURATION_MS, y as phoneticScriptAssetContent, yt as resolveSpeechOverlapByShiftingVideos, z as assembleEntityContent } from "./document-e4Y1QNMu.js";
 import { addSpeechesInputSchema, addVideoClipsInputSchema, adjustBgmVolumeInputSchema, adjustSpeechVolumeInputSchema, adjustVideoClipDurationInputSchema, adjustVideoClipVolumeInputSchema, changeSpeechScriptInputSchema, changeSpeechVoiceInputSchema, deleteBgmInputSchema, deleteSpeechesInputSchema, deleteVideoClipsInputSchema, moveSpeechesInputSchema, moveVideoClipsByAnchorInputSchema, moveVideoClipsInputSchema, replaceVideoClipContentInputSchema, replaceVideoClipSequenceInputSchema, setBgmInputSchema, setCaptionStyleInputSchema, setCaptionVisibilityInputSchema, setVideoClipSpeedShiftInputSchema, t as schemas_exports } from "./schemas.js";
 import { sha256 } from "@noble/hashes/sha2.js";
 import { bytesToHex } from "@noble/hashes/utils.js";
@@ -1947,6 +1947,208 @@ function cloneRows(rows) {
 	};
 }
 //#endregion
+//#region src/entity-editor/visual-assets-effect.ts
+const receiptKey = (effectId) => `editorEffectReceipt:${effectId}`;
+const effectEntityId = (role, effectId, index) => createEntityId(`entity_visual_effect_${role}_${effectId}_${index}`);
+const effectRelationId = (role, effectId, index) => createRelationId(`relation_visual_effect_${role}_${effectId}_${index}`);
+/** Read the authoritative timeline receipt, not a media-id heuristic. */
+function hasVisualAssetsEffect(rows, effectId) {
+	return rows.entities.find((row) => row.entityKind === "timeline")?.payload[receiptKey(effectId)] === true;
+}
+/**
+* Materialize a host-resolved visual command into native Entity/Relation rows.
+* The result is suitable for one revision-checked `EntityGraphHttpClient.commit`.
+* This does not fetch Assets or write remotely; callers must supply factual media
+* and lineage inputs after their own ownership checks.
+*/
+function applyVisualAssetsEffect(rows, input) {
+	if (!input.effect_id) throw new Error("Visual effect requires an effect_id");
+	if (hasVisualAssetsEffect(rows, input.effect_id)) return rows;
+	if (input.clips.length === 0) throw new Error("Visual effect requires clips");
+	if (input.before_clip_id !== void 0 && input.after_clip_id !== void 0) throw new Error("Visual effect accepts only one placement anchor");
+	const timeline = rows.entities.find((row) => row.entityKind === "timeline");
+	if (!timeline) throw new Error("Visual effect requires a Timeline");
+	if (!rows.entities.some((row) => row.entityKind === "track" && row.payload.role === "video_clip")) throw new Error("Visual effect requires a video Track");
+	const anchor = input.before_clip_id ?? input.after_clip_id;
+	if (anchor && !resolveEntityTimelineLayout(rows).tracks.find((track) => track.role === "video_clip")?.clips.some((clip) => clip.clipEntityId === anchor)) throw new Error(`Visual effect anchor ${anchor} no longer exists`);
+	let prepared = rows;
+	for (const clip of input.clips) {
+		prepared = importEffectMedia(prepared, visualMediaFact(clip));
+		for (const source of clip.lineage?.sources ?? []) if (source.assetId !== clip.media_id) prepared = importEffectMedia(prepared, source);
+		if (clip.lineage?.script) prepared = materializeScript(prepared, clip.lineage.script);
+	}
+	const entityIds = input.clips.map((_, index) => effectEntityId("marker", input.effect_id, index));
+	const relationIds = input.clips.flatMap((_, index) => [
+		effectRelationId("track_clip", input.effect_id, index),
+		effectRelationId("marker", input.effect_id, index),
+		effectRelationId("content", input.effect_id, index)
+	]);
+	const editor = new EntityTimelineEditor(prepared, (prefix) => {
+		const id = (prefix === "entity" ? entityIds : relationIds).shift();
+		if (!id) throw new Error(`Visual effect exhausted deterministic ${prefix} identities`);
+		return id;
+	});
+	for (const clip of input.clips) {
+		if (clip.media_kind !== "image" && clip.media_kind !== "video") throw new Error("Expected visual media");
+		if (clip.lineage?.script && clip.media_kind !== "video") throw new Error("Only Video may derive from Script");
+	}
+	editor.insertMediaClips({
+		timelineEntityId: timeline.entityId,
+		clips: input.clips.map((clip, index) => ({
+			clipEntityId: effectEntityId("clip", input.effect_id, index),
+			media: visualMediaFact(clip),
+			inMs: clip.play_in ?? 0,
+			outMs: clip.play_out ?? clip.media_duration_ms,
+			...clip.volume === void 0 ? {} : { volume: clip.volume }
+		})),
+		insertion: input.before_clip_id !== void 0 ? {
+			kind: "before",
+			clipEntityId: input.before_clip_id
+		} : input.after_clip_id !== void 0 ? {
+			kind: "after",
+			clipEntityId: input.after_clip_id
+		} : {
+			kind: "firstStart",
+			startMs: input.clips.find((clip) => clip.start_ms !== void 0)?.start_ms ?? 0
+		}
+	});
+	let next = editor.rows();
+	const relations = [...next.relations];
+	for (const [clipIndex, clip] of input.clips.entries()) {
+		const output = findMediaId(next, clip.media_id);
+		const seen = /* @__PURE__ */ new Set();
+		for (const [sourceIndex, sourceFact] of (clip.lineage?.sources ?? []).entries()) {
+			if (sourceFact.assetId === clip.media_id || seen.has(sourceFact.assetId)) continue;
+			seen.add(sourceFact.assetId);
+			const source = findMediaId(next, sourceFact.assetId, sourceFact.kind);
+			if (hasDerivation(relations, output, source)) continue;
+			relations.push({
+				relationId: createRelationId(`relation_visual_effect_${input.effect_id}_${clipIndex}_${sourceIndex}`),
+				relationKind: "derived-from",
+				endpoint0EntityId: output,
+				endpoint1EntityId: source,
+				metadata: {},
+				trace: { taskId: clip.lineage.generation_job_id }
+			});
+		}
+		const script = clip.lineage?.script;
+		if (!script) continue;
+		if (relations.filter((relation) => relation.relationKind === "derived-from" && relation.endpoint0EntityId === output && next.entities.some((row) => row.entityId === relation.endpoint1EntityId && row.entityKind === "script")).some((relation) => relation.endpoint1EntityId !== script.entity_id)) throw new Error(`Video ${clip.media_id} already derives from another Script`);
+		if (hasDerivation(relations, output, createEntityId(script.entity_id))) continue;
+		relations.push({
+			relationId: createRelationId(`relation_visual_effect_${input.effect_id}_script_${clipIndex}`),
+			relationKind: "derived-from",
+			endpoint0EntityId: output,
+			endpoint1EntityId: createEntityId(script.entity_id),
+			metadata: {},
+			trace: { taskId: clip.lineage.generation_job_id }
+		});
+	}
+	next = {
+		entities: next.entities,
+		relations
+	};
+	return {
+		entities: next.entities.map((row) => row.entityId === timeline.entityId ? {
+			...row,
+			payload: {
+				...row.payload,
+				[receiptKey(input.effect_id)]: true
+			}
+		} : row),
+		relations: next.relations
+	};
+}
+function visualMediaFact(clip) {
+	return clip.media_kind === "image" ? {
+		assetId: clip.media_id,
+		kind: "image",
+		...clip.storage_key ? { storageKey: clip.storage_key } : {}
+	} : {
+		assetId: clip.media_id,
+		kind: "video",
+		durationMs: clip.media_duration_ms,
+		...clip.storage_key ? { storageKey: clip.storage_key } : {}
+	};
+}
+function materializeScript(rows, script) {
+	const payload = {
+		segments: script.segments.map((segment) => ({
+			segmentId: segment.segment_id,
+			text: segment.text,
+			...segment.language === void 0 ? {} : { language: segment.language }
+		})),
+		contentHash: script.content_hash
+	};
+	if (payload.contentHash !== scriptContentHash(payload.segments)) throw new Error(`Script ${script.entity_id} content hash is invalid`);
+	const existing = rows.entities.find((row) => row.entityId === script.entity_id);
+	if (existing) {
+		if (existing.entityKind !== "script" || existing.payload.contentHash !== payload.contentHash || JSON.stringify(existing.payload.segments) !== JSON.stringify(payload.segments)) throw new Error(`Script ${script.entity_id} identity/content conflict`);
+		return rows;
+	}
+	return {
+		entities: [...rows.entities, {
+			entityId: createEntityId(script.entity_id),
+			entityKind: "script",
+			payload
+		}],
+		relations: rows.relations
+	};
+}
+function importEffectMedia(rows, fact) {
+	const system = fact.kind === "voiceover-recording" ? "memota-speech" : "memota";
+	const resolved = findCanonicalMedia(rows, fact.assetId, system);
+	if (resolved.asset && fact.storageKey !== void 0 && resolved.asset.payload.storageKey !== fact.storageKey) throw new Error(`Media ${fact.assetId} storageKey conflicts with its immutable Asset`);
+	const prepared = resolved.asset ? rows : {
+		entities: [...rows.entities, {
+			entityId: createEntityId(`entity_visual_media_${fact.assetId}_0`),
+			entityKind: "asset",
+			payload: {
+				system,
+				key: fact.assetId,
+				...fact.storageKey ? { storageKey: fact.storageKey } : {}
+			}
+		}],
+		relations: rows.relations
+	};
+	const voiceDescriptor = fact.kind === "voiceover-recording" ? fact.voice : void 0;
+	const existingVoice = voiceDescriptor ? rows.entities.find((row) => {
+		const voice = row.payload.voice;
+		return row.entityKind === "voice" && voice !== void 0 && voice.system === voiceDescriptor.system && voice.key === voiceDescriptor.key && voice.name === voiceDescriptor.name;
+	}) : void 0;
+	const hasTimbre = resolved.media !== void 0 && rows.relations.some((relation) => relation.relationKind === "voice-timbre" && relation.endpoint0EntityId === resolved.media.entityId);
+	const entities = [...resolved.media ? [] : [createEntityId(`entity_visual_media_${fact.assetId}_1`)], ...fact.kind === "voiceover-recording" && fact.voice && !existingVoice ? [createEntityId(`entity_visual_media_${fact.assetId}_2`)] : []];
+	const relations = [...resolved.media ? [] : [createRelationId(`relation_visual_media_${fact.assetId}_0`)], ...fact.kind === "voiceover-recording" && fact.voice && !hasTimbre ? [createRelationId(`relation_visual_media_${fact.assetId}_1`)] : []];
+	return importMediaAsset(prepared, fact, (prefix) => {
+		const id = (prefix === "entity" ? entities : relations).shift();
+		if (!id) throw new Error(`Media ${fact.assetId} exhausted deterministic ${prefix} slots`);
+		return id;
+	}).rows;
+}
+function findMediaId(rows, mediaId, kind) {
+	const media = findCanonicalMedia(rows, mediaId, kind === "voiceover-recording" ? "memota-speech" : "memota").media;
+	if (!media) throw new Error(`Imported media ${mediaId} is missing`);
+	return media.entityId;
+}
+function findCanonicalMedia(rows, mediaId, system = "memota") {
+	const assets = rows.entities.filter((row) => row.entityKind === "asset" && row.payload.system === system && row.payload.key === mediaId);
+	if (assets.length > 1) throw new Error(`Imported media ${mediaId} has duplicate Asset identities`);
+	const asset = assets[0];
+	if (!asset) return {};
+	const links = rows.relations.filter((relation) => relation.relationKind === "from-asset" && relation.endpoint1EntityId === asset.entityId);
+	if (rows.relations.some((relation) => relation.relationKind === "from-asset" && relation.endpoint0EntityId === asset.entityId)) throw new Error(`Imported media ${mediaId} has reversed from-asset relation`);
+	if (links.length > 1) throw new Error(`Imported media ${mediaId} has duplicate media identities`);
+	const media = rows.entities.find((row) => row.entityId === links[0]?.endpoint0EntityId);
+	if (links.length && (!media || media.entityKind !== "image" && media.entityKind !== "video" && media.entityKind !== "audio" && !(system === "memota-speech" && media.entityKind === "voiceover-recording"))) throw new Error(`Imported media ${mediaId} has invalid media identity`);
+	return {
+		asset,
+		...media ? { media } : {}
+	};
+}
+function hasDerivation(relations, output, source) {
+	return relations.some((relation) => relation.relationKind === "derived-from" && relation.endpoint0EntityId === output && relation.endpoint1EntityId === source);
+}
+//#endregion
 //#region src/entity-editor/revise-audio-script.ts
 /** Revise text as an independent authored document, never as a version-family mutation. */
 function reviseAudioScript(rows, input) {
@@ -5388,4 +5590,4 @@ function serverCovers(serverVV, target) {
 	return covers(server, target);
 }
 //#endregion
-export { DEFAULT_UNIT_TIME_MS, EntityGraphHttpClient, EntityGraphRevisionConflictError, EntityTimelineEditor, EntityTimelineProjectionError, IMPLEMENTED_SEMANTIC_OP_KINDS, LANE_KINDS_IN_STACK_ORDER, LORO_ENTITY_SCHEMA, LoroEntityDocument, LoroEntityDraft, ManualSyncDoc, MedeoHttpDocStorage, MemoryDocStorage, MengineAckFailedError, MengineDocSession, MengineHttpClient, MengineHttpRequestError, MenginePushRejectedError, MirrorVideoDocumentAdapter, PlainMemoryAdapter, SchemaValidator, ScriptCompositionError, SemanticEditor, TIMELINE_SKELETON_DURATION_MS, ValidationError, VideoDocumentValidationError, applyEntityRows, applyFieldChanges, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertFieldChanges, assertMediaAssetWritePolicy, assertValidVideoDocument, audioScriptAssetContent, audioScriptAssetFields, audioScriptAssetHash, audioScriptAssetOf, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, compileEntityRows, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateAlpha23EntityDocument, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, phoneticScriptAssetContent, phoneticScriptAssetHash, phoneticScriptAssetOf, prepareCaptionContent, projectEntityTimeline, publishEntityRows, readDocumentAudioScript, readEntityDocument, readEntityRelationRecords, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveFieldPath, resolveSpeechOverlapByShiftingVideos, reviseAudioScript, safeDurationMs, schemas_exports as schemas, scriptSourceAssetOf, selectAudioScriptSegment, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };
+export { DEFAULT_UNIT_TIME_MS, EntityGraphHttpClient, EntityGraphRevisionConflictError, EntityTimelineEditor, EntityTimelineProjectionError, IMPLEMENTED_SEMANTIC_OP_KINDS, LANE_KINDS_IN_STACK_ORDER, LORO_ENTITY_SCHEMA, LoroEntityDocument, LoroEntityDraft, ManualSyncDoc, MedeoHttpDocStorage, MemoryDocStorage, MengineAckFailedError, MengineDocSession, MengineHttpClient, MengineHttpRequestError, MenginePushRejectedError, MirrorVideoDocumentAdapter, PlainMemoryAdapter, SchemaValidator, ScriptCompositionError, SemanticEditor, TIMELINE_SKELETON_DURATION_MS, ValidationError, VideoDocumentValidationError, applyEntityRows, applyFieldChanges, applyVisualAssetsEffect, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertFieldChanges, assertMediaAssetWritePolicy, assertValidVideoDocument, audioScriptAssetContent, audioScriptAssetFields, audioScriptAssetHash, audioScriptAssetOf, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, compileEntityRows, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hasVisualAssetsEffect, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateAlpha23EntityDocument, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, phoneticScriptAssetContent, phoneticScriptAssetHash, phoneticScriptAssetOf, prepareCaptionContent, projectEntityTimeline, publishEntityRows, readDocumentAudioScript, readEntityDocument, readEntityRelationRecords, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveFieldPath, resolveSpeechOverlapByShiftingVideos, reviseAudioScript, safeDurationMs, schemas_exports as schemas, scriptSourceAssetOf, selectAudioScriptSegment, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };

package/dist/testing.js

@@ -1,4 +1,4 @@
-import { At as base64ToBytes, jt as bytesToBase64, o as createMirrorVideoDocumentAdapter } from "./document-B3RLmTzA.js";
+import { Mt as bytesToBase64, jt as base64ToBytes, o as createMirrorVideoDocumentAdapter } from "./document-e4Y1QNMu.js";
 import { t as classifyUpdate } from "./loro-relay-doc-cJSY-uau.js";
 import { LoroDoc, VersionVector, encodeFrontiers } from "loro-crdt";
 //#region src/testing/in-memory-mengine-server.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mengine/medeo-client",
-  "version": "2.0.1-alpha.29",
+  "version": "2.0.1-alpha.30",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -28,9 +28,9 @@
     "immer": "^10.2.0",
     "loro-mirror": "^2.3.3",
     "zod": "^4.4.3",
-    "@mengine/storage": "2.0.1-alpha.29",
-    "@mengine/utils": "2.0.1-alpha.29",
-    "@mengine/sync": "2.0.1-alpha.29"
+    "@mengine/storage": "2.0.1-alpha.30",
+    "@mengine/sync": "2.0.1-alpha.30",
+    "@mengine/utils": "2.0.1-alpha.30"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",