@mengine/medeo-client 2.1.1-dsl.1 → 2.1.1-dsl.10

package/dist/{video-draft-types-TXRv3wS6.js → video-draft-types-BnbfWrBx.js}

@@ -21,29 +21,22 @@ function resourceId(kind, system, key) {
 function relationId(table, value) {
 	const v = value;
 	switch (table) {
-		case "clip-source-relations": return `cs:${v.clipId}`;
-		case "time-anchor-relations": return `ta:${v.from}`;
-		case "caption-content-relations": return `cc:${v.captionId}`;
-		case "caption-alignment-relations": return `ca:${v.captionId}`;
 		case "voice-timbre-relations": return `voice-timbre:${tupleHash([v.recordingId, v.voiceId])}`;
 		case "derived-from-relations": return `derived-from:${tupleHash([v.entityId, v.sourceId])}`;
-		case "from-asset-relations": return `from-asset:${v.audioScriptId}`;
-		case "to-asset-relations": return `to-asset:${v.audioScriptId}`;
 	}
 	throw new Error(`Unknown relation table: ${table}`);
 }
 const defaultIdFactory = (kind) => `${kind}_${globalThis.crypto.randomUUID()}`;
 const resourceKinds = {
 	"media-entities": "media",
-	"voice-entities": "voice",
-	"asset-entities": "asset"
+	"voice-entities": "voice"
 };
 /** A resource row's ID is derived from its locator, so one external resource is one entity. */
 function assertResourceIdentity(table, id, value) {
 	const kind = resourceKinds[table];
 	if (kind && id !== resourceId(kind, value.system, value.key)) throw new Error("Resource identity does not match locator");
 }
-/** A relation row's ID is derived from its uniqueness key. */
+/** A relation row's ID is derived from its two ends. */
 function assertRelationIdentity(table, id, value) {
 	if (id !== relationId(table, value)) throw new Error("Relation ID does not match endpoints");
 }
@@ -61,16 +54,19 @@ const optional$1 = (check) => ({
 	check,
 	optional: true
 });
+const reservedIds = [
+	"$cid",
+	"__proto__",
+	"constructor",
+	"prototype"
+];
+const id = (v) => nonempty(v) && !reservedIds.includes(v);
+const cursor = (v) => v instanceof Cursor;
 function isRecord(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Cursor);
 }
 function assertId(value) {
-	if (!nonempty(value) || [
-		"$cid",
-		"__proto__",
-		"constructor",
-		"prototype"
-	].includes(value)) throw new Error("Expected a nonempty, non-reserved ID");
+	if (!id(value)) throw new Error("Expected a nonempty, non-reserved ID");
 }
 function validLanguage(value) {
 	if (typeof value !== "string") return false;
@@ -126,6 +122,39 @@ const seqMarkerFields = {
 function assertSeqMarker(value) {
 	checkFields(value, seqMarkerFields);
 }
+const timeAnchorFields = {
+	to: required(id),
+	offsetMs: required(integer),
+	fallback_abs_ms: required(nonnegative)
+};
+/** A time anchor's own fields; what it points at is checked by `assertReferenceAdmitted`. */
+function assertTimeAnchor(value) {
+	checkFields(value, timeAnchorFields);
+}
+const selectionFields = {
+	audioScriptId: required(id),
+	segmentId: required(id),
+	start: optional$1(cursor),
+	end: optional$1(cursor)
+};
+/** A whole segment, or a run inside it: both ends or neither. */
+const segmentSelection = (fields) => (v) => object(fields)(v) && v.start === void 0 === (v.end === void 0);
+function assertCaptionContent(value) {
+	if (!segmentSelection(selectionFields)(value)) throw new Error("Invalid segment selection");
+}
+const phonemeFields = {
+	...selectionFields,
+	phonemeScript: optional$1(string)
+};
+function assertPhoneme(value) {
+	if (!segmentSelection(phonemeFields)(value)) throw new Error("Invalid phoneme");
+}
+const segmentFields = {
+	id: required(id),
+	text: required(string)
+};
+/** A script's segments: each with its own id, unique within the script. */
+const segments = (v) => Array.isArray(v) && v.every(object(segmentFields)) && new Set(v.map((segment) => segment.id)).size === v.length;
 const locator = {
 	system: required(oneOf("memota", "memota-speech")),
 	key: required(nonempty)
@@ -138,7 +167,9 @@ const entityFields = {
 	},
 	"clip-entities": {
 		seqMarker: required(object(seqMarkerFields)),
-		volume: optional$1(finite)
+		volume: optional$1(finite),
+		source: required(id),
+		anchor: optional$1(object(timeAnchorFields))
 	},
 	"media-entities": {
 		...locator,
@@ -148,10 +179,18 @@ const entityFields = {
 		digest: optional$1(nonempty)
 	},
 	"audio-script-entities": {
-		body: required(string),
+		segments: required(segments),
 		defaultLanguage: optional$1(validLanguage)
 	},
+	"phonetic-script-entities": {
+		phoneme: optional$1(segmentSelection(phonemeFields)),
+		system: optional$1(oneOf("memota")),
+		key: optional$1(nonempty),
+		storageKey: optional$1(nonempty),
+		digest: optional$1(nonempty)
+	},
 	"caption-entities": {
+		selection: optional$1(segmentSelection(selectionFields)),
 		text: optional$1(string),
 		style: optional$1(object(styleFields))
 	},
@@ -159,55 +198,49 @@ const entityFields = {
 		system: required(oneOf("voice-library")),
 		key: required(nonempty),
 		name: optional$1(string)
-	},
-	"asset-entities": {
-		...locator,
-		storageKey: optional$1(nonempty),
-		digest: optional$1(nonempty)
 	}
 };
 const entityTables = Object.keys(entityFields);
+/**
+* Fields stored as one encoded string: written whole, never merged field by field. A patch to one
+* is merged into the current value first, then the whole value is written.
+*/
+const atomicFields = {
+	"clip-entities": ["seqMarker", "anchor"],
+	"phonetic-script-entities": ["phoneme"],
+	"caption-entities": ["selection"]
+};
 const relationFields = {
-	"clip-source-relations": {
-		clipId: required(nonempty),
-		sourceId: required(nonempty)
-	},
-	"time-anchor-relations": {
-		from: required(nonempty),
-		to: required(nonempty),
-		offsetMs: required(integer),
-		fallback_abs_ms: required(nonnegative)
-	},
-	"caption-content-relations": {
-		captionId: required(nonempty),
-		audioScriptId: required(nonempty),
-		start: required((v) => v instanceof Cursor),
-		end: required((v) => v instanceof Cursor)
-	},
-	"caption-alignment-relations": {
-		captionId: required(nonempty),
-		mediaId: required(nonempty),
-		startMs: required(nonnegative),
-		endMs: required(nonnegative)
-	},
 	"voice-timbre-relations": {
-		recordingId: required(nonempty),
-		voiceId: required(nonempty)
+		recordingId: required(id),
+		voiceId: required(id)
 	},
 	"derived-from-relations": {
-		entityId: required(nonempty),
-		sourceId: required(nonempty)
-	},
-	"from-asset-relations": {
-		audioScriptId: required(nonempty),
-		assetId: required(nonempty)
-	},
-	"to-asset-relations": {
-		audioScriptId: required(nonempty),
-		assetId: required(nonempty)
+		entityId: required(id),
+		sourceId: required(id),
+		sourceDigest: optional$1(nonempty)
 	}
 };
 const relationTables = Object.keys(relationFields);
+const fileFields = [
+	"system",
+	"key",
+	"storageKey",
+	"digest"
+];
+const phonemeScriptOf = (row) => isRecord(row.phoneme) ? row.phoneme.phonemeScript : void 0;
+/**
+* A PhoneticScript as a write leaves it: written for a segment (D181), and its phonemeScript is raw
+* content stored as its file (D178) — with text the row names that file and its digest, without
+* text it has no file, and rewritten text is a new file.
+*/
+function assertPhoneticScript(before, after) {
+	if (!isRecord(after.phoneme)) throw new Error("A PhoneticScript is written for a segment of its base script");
+	if (phonemeScriptOf(after) === void 0) {
+		if (fileFields.some((field) => after[field] !== void 0)) throw new Error("A PhoneticScript without text has no file");
+	} else if (after.system === void 0 || after.key === void 0 || after.digest === void 0) throw new Error("A PhoneticScript stores its phonemeScript as a file: name it by system and key with its digest");
+	if (before !== void 0 && phonemeScriptOf(after) !== phonemeScriptOf(before) && after.digest !== void 0 && after.digest === before.digest) throw new Error("A rewritten phonemeScript is stored again: write its new file");
+}
 function assertEntity(table, value) {
 	checkFields(value, entityFields[table]);
 	if (table === "media-entities") {
@@ -219,15 +252,15 @@ function assertEntity(table, value) {
 /** Validate only touched fields, so an unrelated edit can proceed in a merged, invalid document. */
 function assertEntityPatch(table, patch, current) {
 	if (!isRecord(patch)) throw new Error("Expected an entity patch");
-	if (table === "audio-script-entities" && Object.hasOwn(patch, "body")) throw new Error("Edit body through the Text adapter");
+	if (table === "audio-script-entities" && Object.hasOwn(patch, "segments")) throw new Error("Change segments with segment mutations and edit their text through the Text adapter");
 	if (table === "caption-entities" && current.style !== void 0 && Object.hasOwn(patch, "style") && patch.style === void 0) throw new Error("Reset individual style fields; retain the style Map");
 	if (table === "caption-entities" && current.text !== void 0 && patch.text !== void 0) throw new Error("Edit Caption text through the Text adapter");
-	const next = mergeFields(current, patch);
+	const next = patchRow(table, current, patch);
 	for (const key of Object.keys(patch)) {
 		const field = entityFields[table][key];
 		if (!field || !field.optional && next[key] === void 0 || next[key] !== void 0 && !field.check(next[key])) throw new Error(`Invalid patch field: ${key}`);
 	}
-	if (table === "media-entities" || table === "voice-entities" || table === "asset-entities") {
+	if (table === "media-entities" || table === "voice-entities") {
 		for (const key of [
 			"system",
 			"key",
@@ -243,18 +276,25 @@ function assertEntityPatch(table, patch, current) {
 }
 function assertRelation(table, value) {
 	checkFields(value, relationFields[table]);
-	for (const [key, endpoint] of Object.entries(value)) if (key.endsWith("Id") || key === "from" || key === "to") assertId(endpoint);
+}
+/**
+* The row after a patch. An atomic field merges into its current value, so a partial patch keeps
+* the rest of it; an unreadable stored value is replaced instead, so writing a whole value repairs it.
+*/
+function patchRow(table, current, patch) {
+	const next = mergeFields(current, patch);
+	for (const key of atomicFields[table] ?? []) {
+		const old = current[key];
+		const value = patch[key];
+		if (value !== void 0 && isRecord(old) && old.invalid === true) next[key] = isRecord(value) ? mergeFields({}, value) : value;
+	}
+	return next;
 }
 /** Undefined deletes; nested patches retain sibling fields and an existing empty style Map. */
 function mergeFields(target, patch) {
 	const result = { ...target };
 	for (const [key, value] of Object.entries(patch)) {
-		if ([
-			"$cid",
-			"__proto__",
-			"constructor",
-			"prototype"
-		].includes(key)) throw new Error(`Reserved field: ${key}`);
+		if (reservedIds.includes(key)) throw new Error(`Reserved field: ${key}`);
 		if (value === void 0) delete result[key];
 		else result[key] = isRecord(value) ? mergeFields(isRecord(result[key]) ? result[key] : {}, value) : value;
 	}
@@ -1252,36 +1292,60 @@ function codec(encode, decode) {
 		}
 	};
 }
+/** A Clip's time anchor; the Clip holding it is the anchored end. */
 const timeAnchorCodec = codec((v) => {
-	assertRelation("time-anchor-relations", v);
+	assertTimeAnchor(v);
 	return JSON.stringify({
-		from: v.from,
 		to: v.to,
 		offsetMs: v.offsetMs,
 		fallback_abs_ms: v.fallback_abs_ms
 	});
 }, (raw) => {
 	const v = JSON.parse(raw);
-	assertRelation("time-anchor-relations", v);
+	assertTimeAnchor(v);
 	return v;
 });
+/** A segment selection as stored: a run's Cursors as their native bytes in unpadded base64url. */
+function encodeSelection(v) {
+	return {
+		audioScriptId: v.audioScriptId,
+		segmentId: v.segmentId,
+		...v.start === void 0 || v.end === void 0 ? {} : {
+			start: bytesToBase64url(v.start.encode()),
+			end: bytesToBase64url(v.end.encode())
+		}
+	};
+}
+function decodeSelection(v) {
+	if (!v || typeof v !== "object") throw new Error("Expected a segment selection");
+	const { start, end, ...rest } = v;
+	if (start === void 0 && end === void 0) return rest;
+	if (typeof start !== "string" || typeof end !== "string") throw new Error("Expected encoded Cursor pair");
+	return {
+		...rest,
+		start: Cursor.decode(base64urlToBytes(start)),
+		end: Cursor.decode(base64urlToBytes(end))
+	};
+}
+/** A Caption's selection. */
 const captionContentCodec = codec((v) => {
-	assertRelation("caption-content-relations", v);
+	assertCaptionContent(v);
+	return JSON.stringify(encodeSelection(v));
+}, (raw) => {
+	const value = decodeSelection(JSON.parse(raw));
+	assertCaptionContent(value);
+	return value;
+});
+/** A PhoneticScript's selection and what to synthesize for it, stored as one string so they move together. */
+const phonemeCodec = codec((v) => {
+	assertPhoneme(v);
 	return JSON.stringify({
-		captionId: v.captionId,
-		audioScriptId: v.audioScriptId,
-		start: bytesToBase64url(v.start.encode()),
-		end: bytesToBase64url(v.end.encode())
+		...encodeSelection(v),
+		...v.phonemeScript === void 0 ? {} : { phonemeScript: v.phonemeScript }
 	});
 }, (raw) => {
-	const v = JSON.parse(raw);
-	if (typeof v?.start !== "string" || typeof v?.end !== "string") throw new Error("Expected encoded Cursor pair");
-	const value = {
-		...v,
-		start: Cursor.decode(base64urlToBytes(v.start)),
-		end: Cursor.decode(base64urlToBytes(v.end))
-	};
-	assertRelation("caption-content-relations", value);
+	const value = decodeSelection(JSON.parse(raw));
+	assertPhoneme(value);
 	return value;
 });
 /** A Clip's sequence marker is stored as one string, so it is taken or replaced whole. */
@@ -1304,13 +1368,19 @@ const optional = { required: false };
 const mergeable = { mergeableMapChildContainers: true };
 const strings = (keys) => Object.fromEntries(keys.map((key) => [key, schema.String()]));
 const relation = (keys) => schema.LoroMapRecord(schema.LoroMap(strings(keys)), mergeable);
-const atomicValue = (codec) => schema.String().transform({
+const transform = (codec) => ({
 	...codec,
 	isEqual: "encoded-value-equality",
 	validateEncodedType: true
 });
-const atomic = (codec) => schema.LoroMapRecord(atomicValue(codec));
-/** Only direct children inherit mergeable identity. Body and ordinary entity rows keep normal identities. */
+/** One field stored as one encoded string, so it is taken or replaced whole. */
+const atomicValue = (codec) => schema.String().transform(transform(codec));
+const optionalAtomicValue = (codec) => schema.String(optional).transform(transform(codec));
+/**
+* Only direct children inherit mergeable identity. Text and ordinary entity rows keep normal
+* identities, so deleting a row also drops what a peer wrote into it concurrently: a relation an
+* entity holds at most one of is a field of that row and never outlives it.
+*/
 const medeoDslLoroShape = schema({
 	"timeline-entities": schema.LoroMapRecord(schema.LoroMap({})),
 	"track-entities": schema.LoroMapRecord(schema.LoroMap({
@@ -1319,7 +1389,9 @@ const medeoDslLoroShape = schema({
 	})),
 	"clip-entities": schema.LoroMapRecord(schema.LoroMap({
 		seqMarker: atomicValue(seqMarkerCodec),
-		volume: schema.Number(optional)
+		volume: schema.Number(optional),
+		source: schema.String(),
+		anchor: optionalAtomicValue(timeAnchorCodec)
 	})),
 	"media-entities": schema.LoroMapRecord(schema.LoroMap({
 		kind: schema.String(),
@@ -1330,10 +1402,21 @@ const medeoDslLoroShape = schema({
 		digest: schema.String(optional)
 	}), mergeable),
 	"audio-script-entities": schema.LoroMapRecord(schema.LoroMap({
-		body: schema.LoroText(),
+		segments: schema.LoroMovableList(schema.LoroMap({
+			id: schema.String(),
+			text: schema.LoroText()
+		}), (segment) => segment.id),
 		defaultLanguage: schema.String(optional)
 	})),
+	"phonetic-script-entities": schema.LoroMapRecord(schema.LoroMap({
+		phoneme: atomicValue(phonemeCodec),
+		system: schema.String(optional),
+		key: schema.String(optional),
+		storageKey: schema.String(optional),
+		digest: schema.String(optional)
+	})),
 	"caption-entities": schema.LoroMapRecord(schema.LoroMap({
+		selection: optionalAtomicValue(captionContentCodec),
 		text: schema.LoroText(optional),
 		style: schema.LoroMap({
 			font: schema.LoroMap({
@@ -1359,26 +1442,13 @@ const medeoDslLoroShape = schema({
 		key: schema.String(),
 		name: schema.String(optional)
 	}), mergeable),
-	"asset-entities": schema.LoroMapRecord(schema.LoroMap({
-		system: schema.String(),
-		key: schema.String(),
-		storageKey: schema.String(optional),
-		digest: schema.String(optional)
-	}), mergeable),
 	"contain-relations": schema.LoroTree(schema.LoroMap({ entityId: schema.String() })),
-	"clip-source-relations": relation(["clipId", "sourceId"]),
-	"time-anchor-relations": atomic(timeAnchorCodec),
-	"caption-content-relations": atomic(captionContentCodec),
-	"caption-alignment-relations": schema.LoroMapRecord(schema.LoroMap({
-		captionId: schema.String(),
-		mediaId: schema.String(),
-		startMs: schema.Number(),
-		endMs: schema.Number()
-	}), mergeable),
 	"voice-timbre-relations": relation(["recordingId", "voiceId"]),
-	"derived-from-relations": relation(["entityId", "sourceId"]),
-	"from-asset-relations": relation(["audioScriptId", "assetId"]),
-	"to-asset-relations": relation(["audioScriptId", "assetId"])
+	"derived-from-relations": schema.LoroMapRecord(schema.LoroMap({
+		entityId: schema.String(),
+		sourceId: schema.String(),
+		sourceDigest: schema.String(optional)
+	}), mergeable)
 });
 //#endregion
 //#region ../medeo-dsl/src/schema/document-format.ts
@@ -1407,13 +1477,10 @@ function assertDslDocument(doc) {
 }
 //#endregion
 //#region ../medeo-dsl/src/schema/text-styles.ts
-/** How rich-text marks extend at their edges: a language runs on into new text, a pause stays on its space. */
-const textStyles = {
-	language: { expand: "after" },
-	pauseMs: { expand: "none" }
-};
+/** How rich-text marks extend at their edges: a language runs on into text typed after it. */
+const textStyles = { language: { expand: "after" } };
 //#endregion
 //#region src/dsl/projection/video-draft-types.ts
 const DEFAULT_UNIT_TIME_MS = 33.333;
 //#endregion
-export { assertRelation as $, hardenCidDescriptors as A, safeStringify as B, applySchemaToInferOptions as C, deepEqual as D, decodeNestedJsonValues as E, isObject as F, valuesEqual as G, stripUndefined as H, isObjectLike as I, getChildSchema as J, CID_KEY as K, isStateAndSchemaOfType as L, inferContainerTypeFromValue as M, insertChildToMap as N, defineCidProperty as O, isArrayLike as P, assertId as Q, isTreeID as R, applyEncode as S, containerIdToContainerType as T, tryInferContainerType as U, schemaToContainerType as V, tryUpdateToContainer as W, assertEntity as X, getMapFieldSchema as Y, assertEntityPatch as Z, isLoroTreeSchema as _, documentFormat as a, assertRelationIdentity as at, validateSchema as b, isInvalidAtomic as c, relationId as ct, getDefaultValue as d, entityTables as et, isContainerSchema as f, isLoroMovableListSchema as g, isLoroMapSchema as h, assertDslDocument as i, validLanguage as it, hasTransform as j, getRootContainerByType as k, timeAnchorCodec as l, resourceId as lt, isLoroListSchema as m, textStyles as n, mergeFields as nt, medeoDslLoroShape as o, assertResourceIdentity as ot, isListLikeSchema as p, getChildContainerSchema as q, UnsupportedDocumentFormatError as r, relationTables as rt, captionContentCodec as s, defaultIdFactory as st, DEFAULT_UNIT_TIME_MS as t, isRecord as tt, schema as u, tupleHash as ut, isRootSchemaType as v, cidsEqual as w, applyDecode as x, schemaContainsIgnoreField as y, isValueOfContainerType as z };
+export { assertEntityPatch as $, getRootContainerByType as A, isValueOfContainerType as B, applyEncode as C, decodeNestedJsonValues as D, containerIdToContainerType as E, isArrayLike as F, tryUpdateToContainer as G, schemaToContainerType as H, isObject as I, getChildContainerSchema as J, valuesEqual as K, isObjectLike as L, hasTransform as M, inferContainerTypeFromValue as N, deepEqual as O, insertChildToMap as P, assertEntity as Q, isStateAndSchemaOfType as R, applyDecode as S, cidsEqual as T, stripUndefined as U, safeStringify as V, tryInferContainerType as W, getMapFieldSchema as X, getChildSchema as Y, assertCaptionContent as Z, isLoroMovableListSchema as _, tupleHash as _t, documentFormat as a, atomicFields as at, schemaContainsIgnoreField as b, isInvalidAtomic as c, mergeFields as ct, schema as d, validLanguage as dt, assertId as et, getDefaultValue as f, assertRelationIdentity as ft, isLoroMapSchema as g, resourceId as gt, isLoroListSchema as h, relationId as ht, assertDslDocument as i, assertTimeAnchor as it, hardenCidDescriptors as j, defineCidProperty as k, phonemeCodec as l, patchRow as lt, isListLikeSchema as m, defaultIdFactory as mt, textStyles as n, assertPhoneticScript as nt, medeoDslLoroShape as o, entityTables as ot, isContainerSchema as p, assertResourceIdentity as pt, CID_KEY as q, UnsupportedDocumentFormatError as r, assertRelation as rt, captionContentCodec as s, isRecord as st, DEFAULT_UNIT_TIME_MS as t, assertPhoneme as tt, timeAnchorCodec as u, relationTables as ut, isLoroTreeSchema as v, applySchemaToInferOptions as w, validateSchema as x, isRootSchemaType as y, isTreeID as z };