@mengine/medeo-tool 1.4.1-alpha.0 → 1.4.1-alpha.2

package/dist/sandbox-api.d.mts

@@ -134,6 +134,11 @@ interface DeleteVoiceoverInput {
   readonly voiceoverClipEntityIds: readonly string[];
 }
 type EmptyRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'audio-script-marker';
+/** Immutable resource content resolved by the host for a document Entity. */
+interface EntityAssetContent {
+  assetId: string;
+  content: JsonValue;
+}
 type EntityId = string;
 interface EntityPayloadByKind {
   axvideo: BoundedDerivedSequencePayload;
@@ -143,10 +148,10 @@ interface EntityPayloadByKind {
     role?: string;
   };
   clip: JsonObject;
-  video: BoundedNativeSequencePayload;
-  audio: BoundedNativeSequencePayload;
-  voice: BoundedNativeSequencePayload;
-  image: UnboundedConstantSequencePayload;
+  video: BoundedNativeSequencePayload & MediaAssetPayload;
+  audio: BoundedNativeSequencePayload & MediaAssetPayload;
+  voice: BoundedNativeSequencePayload & MediaAssetPayload;
+  image: UnboundedConstantSequencePayload & MediaAssetPayload;
   'sequence-marker': JsonObject & {
     sourceRange: {
       start: number;
@@ -184,6 +189,11 @@ interface EntityPayloadByKind {
     baseEntityIds: string[];
     selections: CaptionTextSelection[];
     style?: JsonObject;
+    segmentRanges?: {
+      segmentId: string;
+      startMs: number;
+      endMs: number;
+    }[];
   };
 }
 interface EntityStoreSnapshot {
@@ -286,6 +296,12 @@ type LinkRelationInput = (LinkRelationBase & {
     alignment: JsonValue;
   };
 });
+type MediaAssetPayload = JsonObject & {
+  external: {
+    system: 'memota' | 'memota-speech';
+    key: string;
+  };
+};
 interface MoveClipInput {
   readonly clipEntityId: string;
   readonly trackEntityId: string;
@@ -373,7 +389,7 @@ interface SetClipVolumeInput {
   readonly volume: number;
 }
 /** Stored own fields; a variant may obtain required content fields from its declared bases. */
-type StoredEntityPayload<K extends KnownEntityKind> = EntityPayloadByKind[K] | (JsonObject & Partial<EntityPayloadByKind[K]> & {
+type StoredEntityPayload<K extends KnownEntityKind> = EntityPayloadByKind[K] | (K extends 'caption' ? JsonObject & Pick<MediaAssetPayload, 'external'> : never) | (JsonObject & Partial<EntityPayloadByKind[K]> & {
   baseEntityIds: string[];
 });
 interface TrimClipInput {
@@ -445,9 +461,11 @@ declare const edit: EditApi;
 declare const timeline: TimelineApi;
 declare const entities: BusinessEntityFacade;
 declare const relations: BusinessRelationFacade;
+/** Resolve the resource attached to an Entity through the host; await before using a new Caption. */
+declare function rgetAssetFromEntity(entityId: string): Promise<EntityAssetContent>;
 declare function checkpoint(): SandboxCheckpoint;
 declare function rollbackTo(cp: SandboxCheckpoint): void;
 declare const inputs: Readonly<Record<string, unknown>>;
 //#endregion
-export type { BoundedDerivedSequencePayload, BoundedNativeSequencePayload, BusinessEntityFacade, BusinessRelationFacade, CaptionFontDescriptor, CaptionSegmentSelection, CaptionStyleFields, CaptionTextRange, CaptionTextSelection, ClipEntityId, ClipPlacement, ComposedPhoneticContent, ComposedScriptContent, CreateEntityInput, DeleteBgmInput, DeleteClipInput, DeleteClipTreeInput, DeleteEntityInput, DeleteVoiceoverInput, EditApi, EmptyRelationKind, EntityId, EntityPayloadByKind, EntityStoreSnapshot, InsertCaptionClipInput, InsertClipInput, InsertPlacedClipInput, JsonObject, JsonPrimitive, JsonValue, KnownEntityKind, KnownRelationKind, LinearClipSpeed, LinkAudioScriptSourceRelationInput, LinkClipAnchorRelationInput, LinkGeneratedRelationInput, LinkPhoneticScriptRenderRelationInput, LinkRelationInput, MoveClipInput, MoveClipsToStartsInput, MoveSequentialClipsInput, MoveVoiceoverInput, PatchCaptionStyleInput, ReplaceClipContentInput, SandboxCheckpoint, SandboxEntity, SandboxRelation, ScriptTextSegment, SequenceDuration, SequenceRange, SequentialClipAnchor, SetCaptionVisibilityInput, SetClipPlacementInput, SetClipSpeedInput, SetClipVolumeInput, StoredEntityPayload, TimelineApi, TrimClipInput, UnboundedConstantSequencePayload, UnlinkRelationInput, UpdateClipInput, UpdateClipMarkerInput, UpdateEntityInput, checkpoint, edit, entities, inputs, relations, rollbackTo, timeline };
+export type { BoundedDerivedSequencePayload, BoundedNativeSequencePayload, BusinessEntityFacade, BusinessRelationFacade, CaptionFontDescriptor, CaptionSegmentSelection, CaptionStyleFields, CaptionTextRange, CaptionTextSelection, ClipEntityId, ClipPlacement, ComposedPhoneticContent, ComposedScriptContent, CreateEntityInput, DeleteBgmInput, DeleteClipInput, DeleteClipTreeInput, DeleteEntityInput, DeleteVoiceoverInput, EditApi, EmptyRelationKind, EntityAssetContent, EntityId, EntityPayloadByKind, EntityStoreSnapshot, InsertCaptionClipInput, InsertClipInput, InsertPlacedClipInput, JsonObject, JsonPrimitive, JsonValue, KnownEntityKind, KnownRelationKind, LinearClipSpeed, LinkAudioScriptSourceRelationInput, LinkClipAnchorRelationInput, LinkGeneratedRelationInput, LinkPhoneticScriptRenderRelationInput, LinkRelationInput, MediaAssetPayload, MoveClipInput, MoveClipsToStartsInput, MoveSequentialClipsInput, MoveVoiceoverInput, PatchCaptionStyleInput, ReplaceClipContentInput, SandboxCheckpoint, SandboxEntity, SandboxRelation, ScriptTextSegment, SequenceDuration, SequenceRange, SequentialClipAnchor, SetCaptionVisibilityInput, SetClipPlacementInput, SetClipSpeedInput, SetClipVolumeInput, StoredEntityPayload, TimelineApi, TrimClipInput, UnboundedConstantSequencePayload, UnlinkRelationInput, UpdateClipInput, UpdateClipMarkerInput, UpdateEntityInput, checkpoint, edit, entities, inputs, relations, rgetAssetFromEntity, rollbackTo, timeline };
 //# sourceMappingURL=sandbox-api.d.mts.map

package/dist/{script-session-DTq_VPEA.mjs → script-session-lXpqmupK.mjs}

@@ -868,6 +868,8 @@ function validateVoicePayload(value, problems) {
 	if (voice.name !== void 0 && typeof voice.name !== "string") problems.push("voice.name must be a string when present");
 }
 function validateCaptionPayload(value, problems) {
+	validateExternalLocator(value, problems);
+	if (value.segmentRanges !== void 0) validateSegmentRanges(value.segmentRanges, problems);
 	const selections = value.selections;
 	if (!Array.isArray(selections)) problems.push("selections must be a non-empty array of AudioScript segment selections");
 	else {
@@ -1006,7 +1008,7 @@ function isOwnedLocalEntityValuePath(entityKind, path) {
 		"axvideo"
 	].includes(entityKind) && /^(?:sampling|coordinateSpace|coordinateSpace\.unit|extent\.kind)$/.test(path)) return true;
 	if (entityKind === "sequence-marker" && /^(?:durationPolicy|duration\.mode|timeRemapping\.(?:kind|mode))$/.test(path)) return true;
-	if (entityKind === "sequence-marker" && /^segmentRanges\[\d+\]\.segmentId$/.test(path)) return true;
+	if ((entityKind === "sequence-marker" || entityKind === "caption") && /^segmentRanges\[\d+\]\.segmentId$/.test(path)) return true;
 	if (entityKind === "asset" && /^(?:external\.(?:system|key)|storageKey)$/.test(path)) return true;
 	if (isMediaAssetVariantKind(entityKind) && /^(?:external\.(?:system|key)|storageKey)$/.test(path)) return true;
 	if (entityKind === "voice" && /^voice\.(?:system|key|name)$/.test(path)) return true;
@@ -1026,7 +1028,7 @@ function isOwnedLocalIdPath(entityKind, path) {
 		"phonetic-script"
 	].includes(entityKind) && /^segments\[\d+\]\.segmentId$/.test(path)) return true;
 	if (entityKind === "caption" && /^selections\[\d+\]\.segmentId$/.test(path)) return true;
-	if (entityKind === "sequence-marker" && /^segmentRanges\[\d+\]\.segmentId$/.test(path)) return true;
+	if ((entityKind === "sequence-marker" || entityKind === "caption") && /^segmentRanges\[\d+\]\.segmentId$/.test(path)) return true;
 	if (entityKind === "asset" && /^(?:tracks\[\d+\]\.trackId|renditions\[\d+\]\.renditionId)$/.test(path)) return true;
 	return false;
 }
@@ -1518,8 +1520,8 @@ function errorMessage(error) {
 }
 //#endregion
 //#region src/sandbox/business-facades.ts
-/** Resource locators are host-owned even when stored on a typed media entity. */
-const infrastructureFields = new Set(["external", "storageKey"]);
+/** Resource IDs are entity data; physical storage paths remain host-owned. */
+const infrastructureFields = new Set(["storageKey"]);
 function businessEntity(entity) {
 	return {
 		...entity,
@@ -2474,4 +2476,4 @@ function replayJournalSync(adapter, journal) {
 //#endregion
 export { createEntityId as a, collectAffectedPartIds as c, businessState as i, renderPreview as l, EntitySandbox as n, createRelationId as o, businessFacades as r, isMediaAssetVariantKind as s, EditSandboxSession as t, renderCompactProjection as u };
 
-//# sourceMappingURL=script-session-DTq_VPEA.mjs.map
+//# sourceMappingURL=script-session-lXpqmupK.mjs.map