@mengine/medeo-client 2.0.1-alpha.16 → 2.0.1-alpha.18

package/dist/{document-ecRldQY4.js → document-yPiwEmkJ.js}

@@ -1460,9 +1460,9 @@ function emptyLaneTracks() {
 * `Caption` declares `Sequence` on purpose: it owns the display timing of the
 * one AudioScript segment it shows, which is what admits it into a Clip.
 * `Voice` declares no `Sequence` — it is a timbre identity, not playable
-* content; a rendered voiceover is an `audio` entity.
+* content; rendered speech is a `voiceover` entity.
 *
-* `Asset` says only that an entity of that kind may be bound to stored bytes,
+* `MediaFile` says only that an entity of that kind may be bound to stored bytes,
 * and asks nothing of its payload. Which bytes, and which way the content
 * flowed, is the `from-asset` / `to-asset` Relation's answer alone.
 */
@@ -1481,27 +1481,32 @@ const ENTITY_KINDS = Object.freeze({
 		"Sequence",
 		"Visual",
 		"Audible",
-		"Asset"
+		"MediaFile"
 	]),
 	audio: Object.freeze([
 		"Sequence",
 		"Audible",
-		"Asset"
+		"MediaFile"
+	]),
+	voiceover: Object.freeze([
+		"Sequence",
+		"Audible",
+		"MediaFile"
 	]),
 	image: Object.freeze([
 		"Sequence",
 		"Visual",
-		"Asset"
+		"MediaFile"
 	]),
 	voice: Object.freeze(["Container", "IPBound"]),
 	"sequence-marker": Object.freeze([]),
 	viewport: Object.freeze([]),
-	"audio-script": Object.freeze(["SegmentText", "Asset"]),
-	"phonetic-script": Object.freeze(["SegmentText", "Asset"]),
+	"audio-script": Object.freeze(["SegmentText", "MediaFile"]),
+	"phonetic-script": Object.freeze(["SegmentText", "MediaFile"]),
 	caption: Object.freeze([
 		"SegmentText",
 		"Sequence",
-		"Asset"
+		"MediaFile"
 	])
 });
 /** What a known kind declares; extension kinds declare nothing through this table. */
@@ -1528,7 +1533,7 @@ function isSequenceFields(value) {
 	return duration === null || typeof duration === "number" && Number.isSafeInteger(duration) && duration > 0;
 }
 function isMediaAssetVariantKind(kind) {
-	return kind === "video" || kind === "image" || kind === "audio";
+	return kind === "video" || kind === "image" || kind === "audio" || kind === "voiceover";
 }
 function isKnownEntityKind(kind) {
 	return Object.hasOwn(ENTITY_KINDS, kind);
@@ -2463,7 +2468,7 @@ const markerContentRelationSpec = Object.freeze({
 /**
 * `from-asset(entity, asset)` — the entity was made from that stored resource.
 *
-* Eligibility is declared: the non-Asset endpoint must carry the `Asset` kind,
+* Eligibility is declared: the non-Asset endpoint must carry the `MediaFile` kind,
 * which says an entity of that kind can be bound to stored bytes and asks
 * nothing of its payload. The bytes stay named in exactly one place, so no
 * entity copies the locator into its own row and one Asset can back several
@@ -2502,7 +2507,7 @@ const generatedRelationSpec = Object.freeze({
 });
 const captionAlignmentRelationSpec = Object.freeze({
 	kind: "caption-alignment",
-	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["caption"]), new Set(["audio"])),
+	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["caption"]), new Set(["voiceover"])),
 	validateMetadata: isCaptionAlignmentMetadata
 });
 /** `clip-anchor(child, host)` means endpoint 0 follows endpoint 1. */
@@ -2512,28 +2517,36 @@ const clipAnchorRelationSpec = Object.freeze({
 	validateMetadata: isEmptyMetadata
 });
 /**
-* The rendered voiceover Audio and the PhoneticScript it was synthesized from;
-* kinds determine roles regardless of endpoint positions.
+* The Voiceover and the PhoneticScript it was spoken from; kinds determine
+* roles regardless of endpoint positions.
+*
+* Every Voiceover must carry one: which words were said, and how, is the only
+* thing that makes speech reproducible, and a Voiceover that cannot answer it
+* is refused when its plan is built.
 */
 const phoneticScriptRenderRelationSpec = Object.freeze({
 	kind: "phonetic-script-render",
-	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["audio"]), new Set(["phonetic-script"])),
+	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["voiceover"]), new Set(["phonetic-script"])),
 	validateMetadata: isEmptyMetadata
 });
 /**
-* The timbre identity a rendered voiceover Audio was synthesized with. Voice
-* stays an identity: it never carries the audio itself, so the link between the
-* two is a Relation rather than one shared entity.
+* The timbre identity a Voiceover was synthesized with. Voice stays an
+* identity: it never carries the audio itself, so the link between the two is a
+* Relation rather than one shared entity, and several takes can name one voice.
 */
 const voiceTimbreRelationSpec = Object.freeze({
 	kind: "voice-timbre",
-	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["audio"]), new Set(["voice"])),
+	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["voiceover"]), new Set(["voice"])),
 	validateMetadata: isEmptyMetadata
 });
 /** AudioScript was transcribed from Audio, Video, or recorded Voice; kinds determine roles. */
 const audioScriptSourceRelationSpec = Object.freeze({
 	kind: "audio-script-source",
-	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["audio-script"]), new Set(["audio", "video"])),
+	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["audio-script"]), new Set([
+		"audio",
+		"voiceover",
+		"video"
+	])),
 	validateMetadata: isEmptyMetadata
 });
 /**
@@ -2590,10 +2603,10 @@ function hasExactlyOneAsset(endpoints) {
 	const kinds = endpoints.map((endpoint) => endpoint.current().entityKind);
 	const assets = kinds.map((kind) => kind === "asset");
 	if (assets[0] === assets[1]) return false;
-	return declaresKind(assets[0] ? kinds[1] : kinds[0], "Asset");
+	return declaresKind(assets[0] ? kinds[1] : kinds[0], "MediaFile");
 }
 function isGeneratedMedia(entity) {
-	return entity.entityKind === "video" || entity.entityKind === "image" || entity.entityKind === "audio";
+	return entity.entityKind === "video" || entity.entityKind === "image" || entity.entityKind === "audio" || entity.entityKind === "voiceover";
 }
 function isEmptyMetadata(value) {
 	return isJsonObject(value) && Object.keys(value).length === 0;
@@ -2782,7 +2795,6 @@ var InvalidEntityRelationRowsError = class extends Error {
 		this.name = "InvalidEntityRelationRowsError";
 	}
 };
-/** Decodes database rows into flat entities and validates the complete relation set. */
 function decodeEntityRelationRows(rows, options) {
 	const issues = [];
 	const entitiesById = /* @__PURE__ */ new Map();
@@ -3023,7 +3035,7 @@ function resolveGraphLayout(graph) {
 			if (clip.entityKind !== "clip" || graph.adjacent(clip.entityId, "track-clip").length !== 1) fail(`Clip ${clip.entityId} must belong to exactly one Track`);
 			const marker = graph.one(clip.entityId, "clip-marker", "sequence-marker");
 			const content = graph.one(marker.entityId, "marker-content");
-			if (!(typedRole === "video_clip" ? ["image", "video"] : typedRole === "speech" ? ["audio"] : typedRole === "caption" ? ["caption"] : ["audio"]).includes(content.entityKind)) fail(`unsupported compatibility content kind ${content.entityKind} on ${typedRole} Track`);
+			if (!(typedRole === "video_clip" ? ["image", "video"] : typedRole === "speech" ? ["voiceover"] : typedRole === "caption" ? ["caption"] : ["audio"]).includes(content.entityKind)) fail(`unsupported compatibility content kind ${content.entityKind} on ${typedRole} Track`);
 			const source = range(marker.payload.sourceRange, "sourceRange");
 			const durationFact = marker.payload.duration;
 			if (!object(durationFact)) fail(`Marker ${marker.entityId} requires duration`);
@@ -4715,4 +4727,4 @@ function createPlainMemoryAdapter(document, options) {
 	return new PlainMemoryAdapter(document, options);
 }
 //#endregion
-export { validateVideoDocument as $, EntityTimelineProjectionError as A, variantBaseEntityIds as B, equalJson as C, partUnionToDraft as Ct, projectEntityTimeline as D, bytesToBase64 as Dt, resolveFieldPath as E, base64ToBytes as Et, assemblePhoneticScriptContent as F, isMediaAssetVariantKind as G, createEntityId as H, assembleScriptText as I, derivePositionFromAbs as J, buildInitialVideoDocument as K, findComposedAudioScript as L, ScriptCompositionError as M, assembleCaptionContent as N, EntityProjectionGraph as O, assembleEntityContent as P, assertValidVideoDocument as Q, selectAudioScriptSegment as R, canonicalJson as S, speedOf as St, assertFieldChanges as T, videoDocumentMirrorSchema as Tt, createRelationId as U, isJsonObject as V, hasSequence as W, toVideoDocument as X, fromVideoDocument as Y, VideoDocumentValidationError as Z, audioScriptAssetOf as _, isEmptyVideoClip as _t, createMirrorVideoDocument as a, hasResolvedPlacement as at, phoneticScriptAssetOf as b, DEFAULT_UNIT_TIME_MS as bt, DocumentMutationGuard as c, cascadeAfterVideoClipChanges as ct, LoroEntityDraft as d, reassignSpeechesToVideoClipsByTime as dt, partUnionSchema as et, readEntityDocument as f, recalculateTimelineDuration as ft, audioScriptAssetHash as g, TIMELINE_SKELETON_DURATION_MS as gt, audioScriptAssetFields as h, syncAggregatedClipsTimePosition as ht, MirrorVideoDocumentAdapter as i, findLaneTrack as it, decodeEntityRelationRows as j, resolveEntityTimelineLayout as k, LORO_ENTITY_SCHEMA as l, arrangeMainTrackSeamlessly as lt, audioScriptAssetContent as m, resolveSpeechOverlapByShiftingVideos as mt, createPlainMemoryAdapter as n, LANE_KINDS_IN_STACK_ORDER as nt, createMirrorVideoDocumentAdapter as o, laneTrackId as ot, entityOrderGroups as p, resolveAllSpeechOverlaps as pt, buildSpeechHostMap as q, generatePartId as r, ensureLaneTrack as rt, readVideoDocumentFromDraft as s, solveVideoDocument as st, PlainMemoryAdapter as t, videoDocumentSchema as tt, LoroEntityDocument as u, fillMainTrackTimeGaps as ut, phoneticScriptAssetContent as v, partDurationMs as vt, applyFieldChanges as w, recordEntries as wt, scriptSourceAssetOf as x, effectiveVideoClipDurationMs as xt, phoneticScriptAssetHash as y, safeDurationMs as yt, updateEntityFields as z };
+export { partUnionSchema as $, decodeEntityRelationRows as A, isJsonObject as B, applyFieldChanges as C, recordEntries as Ct, EntityProjectionGraph as D, projectEntityTimeline as E, bytesToBase64 as Et, assembleScriptText as F, buildInitialVideoDocument as G, createRelationId as H, findComposedAudioScript as I, fromVideoDocument as J, buildSpeechHostMap as K, selectAudioScriptSegment as L, assembleCaptionContent as M, assembleEntityContent as N, resolveEntityTimelineLayout as O, assemblePhoneticScriptContent as P, validateVideoDocument as Q, updateEntityFields as R, equalJson as S, partUnionToDraft as St, resolveFieldPath as T, base64ToBytes as Tt, hasSequence as U, createEntityId as V, isMediaAssetVariantKind as W, VideoDocumentValidationError as X, toVideoDocument as Y, assertValidVideoDocument as Z, audioScriptAssetOf as _, partDurationMs as _t, createMirrorVideoDocument as a, laneTrackId as at, phoneticScriptAssetOf as b, effectiveVideoClipDurationMs as bt, DocumentMutationGuard as c, arrangeMainTrackSeamlessly as ct, LoroEntityDraft as d, recalculateTimelineDuration as dt, videoDocumentSchema as et, readEntityDocument as f, resolveAllSpeechOverlaps as ft, audioScriptAssetHash as g, isEmptyVideoClip as gt, audioScriptAssetFields as h, TIMELINE_SKELETON_DURATION_MS as ht, MirrorVideoDocumentAdapter as i, hasResolvedPlacement as it, ScriptCompositionError as j, EntityTimelineProjectionError as k, LORO_ENTITY_SCHEMA as l, fillMainTrackTimeGaps as lt, audioScriptAssetContent as m, syncAggregatedClipsTimePosition as mt, createPlainMemoryAdapter as n, ensureLaneTrack as nt, createMirrorVideoDocumentAdapter as o, solveVideoDocument as ot, entityOrderGroups as p, resolveSpeechOverlapByShiftingVideos as pt, derivePositionFromAbs as q, generatePartId as r, findLaneTrack as rt, readVideoDocumentFromDraft as s, cascadeAfterVideoClipChanges as st, PlainMemoryAdapter as t, LANE_KINDS_IN_STACK_ORDER as tt, LoroEntityDocument as u, reassignSpeechesToVideoClipsByTime as ut, phoneticScriptAssetContent as v, safeDurationMs as vt, assertFieldChanges as w, videoDocumentMirrorSchema as wt, scriptSourceAssetOf as x, speedOf as xt, phoneticScriptAssetHash as y, DEFAULT_UNIT_TIME_MS as yt, variantBaseEntityIds as z };

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

@@ -1037,7 +1037,7 @@ type JsonObject = {
 };
 //#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';
+type KnownEntityKind = 'axvideo' | 'timeline' | 'track' | 'clip' | 'asset' | 'video' | 'audio' | 'voiceover' | 'voice' | 'image' | 'sequence-marker' | 'viewport' | 'audio-script' | 'phonetic-script' | 'caption';
 declare const extensionEntityKindBrand: unique symbol;
 type ExtensionEntityKind = string & {
   readonly [extensionEntityKindBrand]: 'ExtensionEntityKind';