@mengine/medeo-client 1.3.1-alpha.0 → 1.3.1-alpha.2

package/dist/{document-Caidonf8.js → document-BLYcbv8E.js}

@@ -1536,11 +1536,255 @@ function createId(value, label) {
 	return value;
 }
 //#endregion
+//#region ../medeo-dsl/src/json-values.ts
+const nativeObjectConstructorSource = Function.prototype.toString.call(Object);
+function isJsonObject(value) {
+	return isJsonValue(value, /* @__PURE__ */ new Set()) && !Array.isArray(value) && value !== null;
+}
+function isJsonValue(value, ancestors) {
+	if (value === null || typeof value === "string" || typeof value === "boolean") return true;
+	if (typeof value === "number") return Number.isFinite(value);
+	if (typeof value !== "object") return false;
+	if (!Array.isArray(value) && !isPlainObject(value)) return false;
+	if (ancestors.has(value)) return false;
+	ancestors.add(value);
+	const valid = Array.isArray(value) ? value.every((item) => isJsonValue(item, ancestors)) : Object.values(value).every((item) => isJsonValue(item, ancestors));
+	ancestors.delete(value);
+	return valid;
+}
+/** Recognize an ordinary object from any VM realm without admitting class instances. */
+function isPlainObject(value) {
+	try {
+		const prototype = Object.getPrototypeOf(value);
+		if (prototype === null) return true;
+		if (Object.getPrototypeOf(prototype) !== null) return false;
+		const constructor = Object.getOwnPropertyDescriptor(prototype, "constructor")?.value;
+		return typeof constructor === "function" && constructor.prototype === prototype && Function.prototype.toString.call(constructor) === nativeObjectConstructorSource;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+//#region ../medeo-dsl/src/composition.ts
+/** Assembly fails explicitly when declared bases cannot provide valid, unambiguous content. */
+var ScriptCompositionError = class extends Error {
+	code;
+	entityId;
+	constructor(code, entityId, message) {
+		super(message);
+		this.code = code;
+		this.entityId = entityId;
+		this.name = "ScriptCompositionError";
+	}
+};
+/** Direct base IDs are structural fields, never ordinary Relation endpoints. */
+function variantBaseEntityIds(entity) {
+	if (!Object.hasOwn(entity.payload, "baseEntityIds")) return [];
+	const ids = entity.payload.baseEntityIds;
+	if (!Array.isArray(ids) || ids.length === 0 || !ids.every((id) => typeof id === "string" && id.trim() === id && id.length > 0) || new Set(ids).size !== ids.length) throw new ScriptCompositionError("invalid_bases", entity.entityId, `Entity "${entity.entityId}" requires non-empty, unique baseEntityIds`);
+	return ids.map(createEntityId);
+}
+/** Validate all base providers before applying explicit own fields; ordering cannot resolve ambiguity. */
+function assembleEntityContent(rows, entityId) {
+	const byId = /* @__PURE__ */ new Map();
+	for (const row of rows.entities) {
+		if (byId.has(row.entityId)) throw new ScriptCompositionError("composition_ambiguous", row.entityId, `duplicate entity id "${row.entityId}"`);
+		byId.set(row.entityId, row);
+	}
+	const active = /* @__PURE__ */ new Set();
+	const cache = /* @__PURE__ */ new Map();
+	const visit = (id) => {
+		const cached = cache.get(id);
+		if (cached !== void 0) return cached;
+		if (active.has(id)) throw new ScriptCompositionError("composition_cycle", id, `Cyclic baseEntityIds at "${id}"`);
+		const row = byId.get(id);
+		if (row === void 0) throw new ScriptCompositionError("composition_dangling", id, `Missing base entity "${id}" in this document`);
+		if (!isJsonObject(row.payload) || Object.hasOwn(row.payload, "entityId") || Object.hasOwn(row.payload, "entityKind")) throw new ScriptCompositionError("invalid_bases", id, `Entity "${id}" requires JSON own fields without reserved identity fields`);
+		active.add(id);
+		const inherited = {};
+		const providers = /* @__PURE__ */ new Map();
+		for (const baseId of variantBaseEntityIds(row)) {
+			const base = visit(baseId);
+			for (const [field, value] of Object.entries(base.payload)) {
+				if (field === "baseEntityIds") continue;
+				const previous = providers.get(field);
+				if (previous !== void 0) throw new ScriptCompositionError("field_conflict", id, `Entity "${id}" field "${field}" conflicts between bases "${previous}" and "${baseId}"; own fields cannot resolve base ambiguity`);
+				providers.set(field, baseId);
+				Object.defineProperty(inherited, field, {
+					value,
+					enumerable: true,
+					configurable: true,
+					writable: true
+				});
+			}
+		}
+		const assembled = {
+			...row,
+			payload: JSON.parse(JSON.stringify({
+				...inherited,
+				...row.payload
+			}))
+		};
+		active.delete(id);
+		cache.set(id, assembled);
+		return assembled;
+	};
+	return visit(entityId);
+}
+/** Resolve a field's declaring entity after validating the entire composition. */
+function resolveEntityFieldOwner(rows, entityId, field) {
+	assembleEntityContent(rows, entityId);
+	const byId = new Map(rows.entities.map((row) => [row.entityId, row]));
+	const find = (id) => {
+		const row = byId.get(id);
+		if (Object.hasOwn(row.payload, field)) return id;
+		if (field === "baseEntityIds") return void 0;
+		for (const baseId of variantBaseEntityIds(row)) {
+			const owner = find(baseId);
+			if (owner !== void 0) return owner;
+		}
+	};
+	return find(entityId) ?? entityId;
+}
+/** Patch assembled fields without copying inherited fields into the variant's stored payload. */
+function updateEntityFields(rows, entityId, fields) {
+	assembleEntityContent(rows, entityId);
+	if (!isJsonObject(fields) || Object.hasOwn(fields, "entityId") || Object.hasOwn(fields, "entityKind")) throw new ScriptCompositionError("invalid_bases", entityId, "Field updates require JSON without reserved identity fields");
+	const updates = /* @__PURE__ */ new Map();
+	for (const [field, value] of Object.entries(fields)) {
+		const ownerId = resolveEntityFieldOwner(rows, entityId, field);
+		const owner = updates.get(ownerId) ?? rows.entities.find((row) => row.entityId === ownerId);
+		updates.set(ownerId, {
+			...owner,
+			payload: {
+				...owner.payload,
+				[field]: value
+			}
+		});
+	}
+	return [...updates.values()].map((row) => JSON.parse(JSON.stringify(row)));
+}
+/** Find the actual AudioScript text owner through direct variant bases. */
+function findComposedAudioScript(rows, variantEntityId, variantKind) {
+	const variant = requireEntityKind(rows, variantEntityId, variantKind);
+	assembleEntityContent(rows, variantEntityId);
+	const sources = /* @__PURE__ */ new Map();
+	const seen = /* @__PURE__ */ new Set();
+	const visit = (row) => {
+		for (const id of variantBaseEntityIds(row)) {
+			if (seen.has(id)) continue;
+			seen.add(id);
+			const base = rows.entities.find((candidate) => candidate.entityId === id);
+			if (base.entityKind === "audio-script") sources.set(id, assembleEntityContent(rows, id));
+			else visit(base);
+		}
+	};
+	visit(variant);
+	if (sources.size !== 1) throw new ScriptCompositionError(sources.size === 0 ? "composition_missing" : "composition_ambiguous", variantEntityId, `${variantKind} "${variantEntityId}" baseEntityIds must resolve one AudioScript text owner, got ${sources.size}`);
+	return [...sources.values()][0];
+}
+/** Join the whole AudioScript text in segment order. */
+function assembleScriptText(script) {
+	return scriptSegments(script).map((segment) => segment.text).join("");
+}
+function scriptSegments(script) {
+	const segments = script.payload.segments;
+	if (!Array.isArray(segments)) throw new ScriptCompositionError("composition_dangling", script.entityId, `AudioScript "${script.entityId}" requires segments`);
+	if (!segments.every(isScriptSegment) || new Set(segments.map((s) => s.segmentId)).size !== segments.length) throw new ScriptCompositionError("invalid_script", script.entityId, "AudioScript requires valid segments with unique local segmentId and text");
+	return segments;
+}
+function isScriptSegment(value) {
+	if (typeof value !== "object" || value == null || Array.isArray(value)) return false;
+	const segment = value;
+	return typeof segment.segmentId === "string" && segment.segmentId.trim() !== "" && typeof segment.text === "string" && (segment.language === void 0 || typeof segment.language === "string");
+}
+/** Assemble selected text after base-field validation and explicit variant overrides. */
+function assembleCaptionContent(rows, captionEntityId) {
+	requireEntityKind(rows, captionEntityId, "caption");
+	const caption = assembleEntityContent(rows, captionEntityId);
+	const script = findComposedAudioScript(rows, captionEntityId, "caption");
+	const segments = selectAudioScriptSegments({
+		...script,
+		payload: caption.payload
+	}, captionSelections(caption));
+	return {
+		caption,
+		audioScript: script,
+		segments,
+		text: segments.map((segment) => segment.text).join("")
+	};
+}
+/**
+* Assemble the complete Phonetic Script content for TTS: the composed
+* AudioScript's base text plus the variant's own phoneme and prosody fields.
+*/
+function assemblePhoneticScriptContent(rows, phoneticScriptEntityId) {
+	requireEntityKind(rows, phoneticScriptEntityId, "phonetic-script");
+	const phoneticScript = assembleEntityContent(rows, phoneticScriptEntityId);
+	const audioScript = findComposedAudioScript(rows, phoneticScriptEntityId, "phonetic-script");
+	const segments = scriptSegments({
+		...audioScript,
+		payload: phoneticScript.payload
+	});
+	return {
+		phoneticScript,
+		audioScript,
+		segments,
+		text: segments.map((segment) => segment.text).join("")
+	};
+}
+function captionSelections(caption) {
+	const selections = caption.payload.selections;
+	if (!Array.isArray(selections) || selections.length === 0) throw new ScriptCompositionError("empty_selection", caption.entityId, `Caption "${caption.entityId}" requires a non-empty segment selection into its AudioScript`);
+	if (!selections.every(isSegmentSelection)) throw new ScriptCompositionError("invalid_selection", caption.entityId, "Caption selections require a segmentId and optional textRange");
+	return selections;
+}
+function isSegmentSelection(value) {
+	return typeof value === "object" && value != null && !Array.isArray(value) && typeof value.segmentId === "string" && value.segmentId.trim() !== "" && Object.keys(value).every((key) => key === "segmentId" || key === "textRange");
+}
+/** Select source text without creating another authoritative text field. */
+function selectAudioScriptSegments(script, selections) {
+	if (!Array.isArray(selections) || selections.length === 0 || !selections.every(isSegmentSelection) || new Set(selections.map((s) => s.segmentId)).size !== selections.length) throw new ScriptCompositionError("invalid_selection", script.entityId, "Caption selections must be non-empty and name unique source segments");
+	const bySegmentId = new Map(scriptSegments(script).map((segment) => [segment.segmentId, segment]));
+	const selected = selections.map((selection) => {
+		const segment = bySegmentId.get(selection.segmentId);
+		if (segment === void 0) throw new ScriptCompositionError("unknown_segment", script.entityId, `Caption selection "${selection.segmentId}" does not name a segment of AudioScript "${script.entityId}"`);
+		if (selection.textRange === void 0) return segment;
+		const range = selection.textRange;
+		const points = Array.from(segment.text);
+		if (typeof range !== "object" || range === null || !Number.isSafeInteger(range.start) || !Number.isSafeInteger(range.end) || range.start < 0 || range.end <= range.start || range.end > points.length || Object.keys(range).some((key) => key !== "start" && key !== "end")) throw new ScriptCompositionError("invalid_selection", script.entityId, "Caption textRange must be a non-empty half-open Unicode code-point range within its source segment");
+		return {
+			...segment,
+			text: points.slice(range.start, range.end).join("")
+		};
+	});
+	if (!selected.map((segment) => segment.text).join("").trim()) throw new ScriptCompositionError("empty_selection", script.entityId, "Caption selection must contain visible source text");
+	return selected;
+}
+function requireEntityKind(rows, entityIdValue, entityKind) {
+	const entity = rows.entities.find((candidate) => candidate.entityId === entityIdValue);
+	if (entity === void 0) throw new ScriptCompositionError("composition_dangling", entityIdValue, `Entity "${entityIdValue}" does not exist`);
+	if (entity.entityKind !== entityKind) throw new ScriptCompositionError("composition_dangling", entityIdValue, `Entity "${entityIdValue}" must have kind "${entityKind}", got "${entity.entityKind}"`);
+	return entity;
+}
+//#endregion
+//#region ../medeo-dsl/src/rows.ts
+function entityToRow(entity) {
+	const { entityId, entityKind, ...payload } = entity;
+	if (!isJsonObject(payload)) throw new Error(`Entity "${entityId}" payload must contain only JSON values`);
+	return {
+		entityId,
+		entityKind,
+		payload
+	};
+}
+//#endregion
 //#region ../medeo-dsl/src/invariants.ts
 /**
 * Media variants own their Asset identity directly: a `physical-asset`
-* Relation may not bind them. Caption inline text (and other non-media
-* Sequence entities) keep their Asset binding.
+* Relation may not bind them. Caption text is composed domain content, so
+* Captions do not bind Physical Assets either; the Relation vocabulary stays
+* open for future physical pipeline semantics.
 */
 function validateMediaAssetIdentity(entity, index) {
 	return [...index.relationsOf(entity)].filter((relation) => relation.kind === "physical-asset").map(() => ({
@@ -1553,6 +1797,19 @@ function validateMediaAssetIdentity(entity, index) {
 function validateEntityRelationSet(entityRefs, index, options) {
 	const { entities, issues } = collectRelatedEntities(entityRefs, index);
 	const entityIds = new Set(entities.map((entity) => entity.entityId));
+	const rows = {
+		entities: entities.map((entity) => entityToRow(entity.current())),
+		relations: []
+	};
+	for (const entity of entities) try {
+		assembleEntityContent(rows, entity.entityId);
+	} catch (error) {
+		issues.push({
+			code: "invalid_variant_composition",
+			entityId: entity.entityId,
+			message: error instanceof Error ? error.message : "Invalid variant composition"
+		});
+	}
 	for (const entity of entities) {
 		const current = entity.current();
 		const entityIssues = validateEntity(entity, entityIds);
@@ -1573,7 +1830,8 @@ function validateEntityRelationSet(entityRefs, index, options) {
 			issues.push(...validateClipPlacement(entity, index));
 		}
 		if (current.entityKind === "axvideo") issues.push(...validateAXVideoAdmission(entity, index));
-		if (current.entityKind === "caption") issues.push(...validateCaptionAsset(entity, index));
+		if (current.entityKind === "caption") issues.push(...validateCaptionComposition(entity, index, entities));
+		if (current.entityKind === "phonetic-script") issues.push(...validatePhoneticComposition(entity, index, entities));
 		issues.push(...validateSequenceComposition(entity));
 	}
 	issues.push(...validateClipAnchorCycles(entities, index));
@@ -1676,25 +1934,35 @@ function validateAXVideoAdmission(axVideo, index) {
 		message: "AXVideo must have exactly one live AXVideo-Marker Relation"
 	}];
 }
-function validateCaptionAsset(caption, index) {
-	const assets = ofKind([...index.relationsOf(caption)], "physical-asset").map((relation) => relation.other(caption)?.deref()?.current()).filter((entity) => entity?.entityKind === "asset");
-	if (assets.length > 0) {
-		const captionText = caption.current().text;
-		if (!assets.some((asset) => {
-			const inline = asset.inline;
-			return isRecord(inline) && inline.mediaType === "text/plain" && inline.text !== captionText;
-		})) return [];
-		return [{
-			code: "caption_inline_asset_mismatch",
-			entityId: caption.entityId,
-			message: "Caption text must match the text/plain inline Physical Asset"
-		}];
+/** Validate a Caption against the complete entity set, including its directly held bases. */
+function validateCaptionComposition(caption, index, entities = []) {
+	return validateVariantComposition(caption, index, entities, "caption");
+}
+function validatePhoneticComposition(phonetic, index, entities = []) {
+	return validateVariantComposition(phonetic, index, entities, "phonetic-script");
+}
+function validateVariantComposition(variant, index, entities, kind) {
+	const issues = [];
+	if (kind === "caption" && ofKind([...index.relationsOf(variant)], "physical-asset").length > 0) issues.push({
+		code: "caption_physical_asset_forbidden",
+		entityId: variant.entityId,
+		message: "Caption text is composed from its AudioScript; Caption must not bind a Physical Asset"
+	});
+	const rows = {
+		entities: collectRelatedEntities([...entities, variant], index).entities.map((ref) => entityToRow(ref.current())),
+		relations: []
+	};
+	try {
+		if (kind === "caption") assembleCaptionContent(rows, variant.entityId);
+		else assemblePhoneticScriptContent(rows, variant.entityId);
+	} catch (error) {
+		issues.push({
+			code: kind === "caption" ? "caption_composition_required" : "phonetic_script_composition_required",
+			entityId: variant.entityId,
+			message: error instanceof Error ? error.message : "Invalid variant composition"
+		});
 	}
-	return [{
-		code: "caption_asset_required",
-		entityId: caption.entityId,
-		message: "Caption must have a Physical Asset Relation"
-	}];
+	return issues;
 }
 function validateClipPlacement(clip, index) {
 	const marker = ofKind([...index.relationsOf(clip)], "clip-marker")[0]?.other(clip)?.deref();
@@ -1822,6 +2090,18 @@ function validateKnownEntityPayload(entity) {
 	const value = entity;
 	const problems = [];
 	if (value.lifecycle !== void 0 && !isRecord(value.lifecycle)) problems.push("lifecycle must be an object when present");
+	if (entity.entityKind === "audio-script" || entity.entityKind === "phonetic-script") {
+		for (const key of [
+			"extent",
+			"sampling",
+			"coordinateSpace",
+			"sourceRange",
+			"targetRange",
+			"duration",
+			"startMs",
+			"endMs"
+		]) if (Object.hasOwn(value, key)) problems.push(`${key} is not intrinsic script data; assign an external annotation Marker`);
+	}
 	switch (entity.entityKind) {
 		case "track":
 			validateOptionalField(value, "hidden", "boolean", problems);
@@ -1848,9 +2128,11 @@ function validateKnownEntityPayload(entity) {
 			validateMarkerPayload(value, problems);
 			break;
 		case "audio-script":
-		case "phonetic-script":
 			validateScriptPayload(value, problems);
 			break;
+		case "phonetic-script":
+			validatePhoneticScriptPayload(value, problems);
+			break;
 		case "timeline":
 		case "viewport": break;
 		case "clip":
@@ -1914,24 +2196,18 @@ function validateSegmentRanges(value, problems) {
 function validateAssetPayload(value, problems) {
 	validateExternalLocator(value, problems);
 	validateStorageKey(value, problems);
-	const inline = value.inline;
-	if (inline !== void 0) if (!isRecord(inline)) problems.push("inline must be an object when present");
-	else {
-		if (inline.mediaType !== "text/plain") problems.push("inline.mediaType must be \"text/plain\"");
-		if (typeof inline.text !== "string") problems.push("inline.text must be a string");
-	}
-	if (value.external !== void 0 && value.inline !== void 0) problems.push("Asset must not combine external and inline physical locations");
+	if (value.inline !== void 0) problems.push("inline is not a physical location; text is domain content owned by its AudioScript");
 }
 /**
 * Media variants own their Asset locator directly: `external` is required and
-* inline text stays an Asset-kind-only value so the two physical-location
+* textual domain content is owned by AudioScript; the physical-location
 * vocabularies cannot mix.
 */
 function validateMediaAssetFields(value, problems) {
 	if (value.external === void 0) problems.push("external is required; media variants own their Asset identity");
 	else validateExternalLocator(value, problems);
 	validateStorageKey(value, problems);
-	if (value.inline !== void 0) problems.push("inline is an Asset-kind field; media variants use external");
+	if (value.inline !== void 0) problems.push("media variants use external locators, not inline domain text");
 }
 function validateExternalLocator(value, problems) {
 	const external = value.external;
@@ -1958,7 +2234,26 @@ 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) {
-	if (value.text !== void 0 && typeof value.text !== "string") problems.push("text must be a string when present");
+	const selections = value.selections;
+	if (!Array.isArray(selections)) problems.push("selections must be a non-empty array of AudioScript segment selections");
+	else {
+		if (selections.length === 0) problems.push("selections must name at least one AudioScript segment");
+		const seen = /* @__PURE__ */ new Set();
+		for (const [index, selection] of selections.entries()) {
+			if (!isRecord(selection)) {
+				problems.push(`selections[${index}] must be an object`);
+				continue;
+			}
+			if (typeof selection.segmentId !== "string" || selection.segmentId.trim() === "") problems.push(`selections[${index}].segmentId must be a string`);
+			else if (seen.has(selection.segmentId)) problems.push(`selections[${index}].segmentId must be unique within the Caption`);
+			else seen.add(selection.segmentId);
+			if (Object.keys(selection).some((key) => key !== "segmentId" && key !== "textRange")) problems.push(`selections[${index}] may only contain segmentId and textRange`);
+			if (selection.textRange !== void 0) {
+				const range = selection.textRange;
+				if (!isRecord(range) || !Number.isSafeInteger(range.start) || !Number.isSafeInteger(range.end) || range.start < 0 || range.end <= range.start || Object.keys(range).some((key) => key !== "start" && key !== "end")) problems.push(`selections[${index}].textRange must be a non-empty half-open code-point range`);
+			}
+		}
+	}
 	const style = value.style;
 	if (style === void 0) return;
 	if (!isRecord(style)) {
@@ -1993,6 +2288,12 @@ function validateRange(value, path, required, problems) {
 	if (!Object.hasOwn(value, "start") || value.start === void 0) problems.push(`${path}.start is required`);
 	if (!Object.hasOwn(value, "end") || value.end === void 0) problems.push(`${path}.end is required`);
 }
+/** Phonetic variants store pronunciation fields only; base text stays in the AudioScript. */
+function validatePhoneticScriptPayload(value, problems) {
+	if (value.segments !== void 0) validateScriptPayload(value, problems);
+	if (value.phonemeScript !== void 0 && (typeof value.phonemeScript !== "string" || value.phonemeScript.trim() === "")) problems.push("phonemeScript must be a non-empty string when present");
+	if (value.prosody !== void 0 && !isRecord(value.prosody)) problems.push("prosody must be an object when present");
+}
 function validateScriptPayload(value, problems) {
 	if (!Array.isArray(value.segments)) {
 		problems.push("segments must be an array");
@@ -2035,6 +2336,7 @@ function visitPeerEntityIdPaths(value, entityKind, parentPath, ancestors, paths)
 	if (Array.isArray(value)) for (const [index, item] of value.entries()) visitPeerEntityIdPaths(item, entityKind, `${parentPath}[${index}]`, ancestors, paths);
 	else for (const [key, child] of Object.entries(value)) {
 		const path = parentPath.length === 0 ? key : `${parentPath}.${key}`;
+		if (parentPath.length === 0 && key === "baseEntityIds") continue;
 		if (!(parentPath.length === 0 && key === "entityId") && !isOwnedLocalIdPath(entityKind, path) && isEntityIdFieldName(key)) paths.push(path);
 		visitPeerEntityIdPaths(child, entityKind, path, ancestors, paths);
 	}
@@ -2054,7 +2356,7 @@ function visitPeerEntityValues(value, entityKind, ownEntityId, entityIds, path,
 	ancestors.add(value);
 	if (Array.isArray(value)) for (const [index, item] of value.entries()) visitPeerEntityValues(item, entityKind, ownEntityId, entityIds, `${path}[${index}]`, ancestors, paths);
 	else for (const [key, child] of Object.entries(value)) {
-		if (path.length === 0 && (key === "entityId" || key === "entityKind")) continue;
+		if (path.length === 0 && (key === "entityId" || key === "entityKind" || key === "baseEntityIds")) continue;
 		visitPeerEntityValues(child, entityKind, ownEntityId, entityIds, path.length === 0 ? key : `${path}.${key}`, ancestors, paths);
 	}
 	ancestors.delete(value);
@@ -2071,16 +2373,25 @@ function isOwnedLocalEntityValuePath(entityKind, path) {
 	].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 === "asset" && /^(?:external\.(?:system|key)|storageKey|inline\.(?:mediaType|text))$/.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;
-	if (entityKind === "caption" && (path === "text" || path.startsWith("style."))) return true;
-	if ((entityKind === "audio-script" || entityKind === "phonetic-script") && /^segments\[\d+\]\.(?:segmentId|text|language)$/.test(path)) return true;
+	if (entityKind === "caption" && (path.startsWith("style.") || /^selections\[\d+\]\.segmentId$/.test(path))) return true;
+	if ([
+		"audio-script",
+		"caption",
+		"phonetic-script"
+	].includes(entityKind) && /^segments\[\d+\]\.(?:segmentId|text|language)$/.test(path)) return true;
 	return false;
 }
 function isOwnedLocalIdPath(entityKind, path) {
 	if (path === "lifecycle.actorId") return true;
-	if ((entityKind === "audio-script" || entityKind === "phonetic-script") && /^segments\[\d+\]\.segmentId$/.test(path)) return true;
+	if ([
+		"audio-script",
+		"caption",
+		"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 === "asset" && /^(?:tracks\[\d+\]\.trackId|renditions\[\d+\]\.renditionId)$/.test(path)) return true;
 	return false;
@@ -2136,35 +2447,6 @@ function ofKind(relations, kind) {
 	return relations.filter((relation) => relation.kind === kind);
 }
 //#endregion
-//#region ../medeo-dsl/src/json-values.ts
-const nativeObjectConstructorSource = Function.prototype.toString.call(Object);
-function isJsonObject(value) {
-	return isJsonValue(value, /* @__PURE__ */ new Set()) && !Array.isArray(value) && value !== null;
-}
-function isJsonValue(value, ancestors) {
-	if (value === null || typeof value === "string" || typeof value === "boolean") return true;
-	if (typeof value === "number") return Number.isFinite(value);
-	if (typeof value !== "object") return false;
-	if (!Array.isArray(value) && !isPlainObject(value)) return false;
-	if (ancestors.has(value)) return false;
-	ancestors.add(value);
-	const valid = Array.isArray(value) ? value.every((item) => isJsonValue(item, ancestors)) : Object.values(value).every((item) => isJsonValue(item, ancestors));
-	ancestors.delete(value);
-	return valid;
-}
-/** Recognize an ordinary object from any VM realm without admitting class instances. */
-function isPlainObject(value) {
-	try {
-		const prototype = Object.getPrototypeOf(value);
-		if (prototype === null) return true;
-		if (Object.getPrototypeOf(prototype) !== null) return false;
-		const constructor = Object.getOwnPropertyDescriptor(prototype, "constructor")?.value;
-		return typeof constructor === "function" && constructor.prototype === prototype && Function.prototype.toString.call(constructor) === nativeObjectConstructorSource;
-	} catch {
-		return false;
-	}
-}
-//#endregion
 //#region ../medeo-dsl/src/relation-specs.ts
 const timelineTrackRelationSpec = emptySpec("timeline-track", "timeline", "track");
 const trackClipRelationSpec = emptySpec("track-clip", "track", "clip");
@@ -2187,8 +2469,6 @@ const generatedRelationSpec = Object.freeze({
 	validateEndpoints: (endpoints) => endpoints.every((endpoint) => isGeneratedMedia(endpoint.current())),
 	validateMetadata: isEmptyMetadata
 });
-const phoneticScriptProvenanceRelationSpec = metadataSpec("phonetic-script-provenance", "phonetic-script", "audio-script", isSegmentAlignmentMetadata);
-const captionProvenanceRelationSpec = metadataSpec("caption-provenance", "caption", "audio-script", isSegmentAlignmentMetadata);
 const captionAlignmentRelationSpec = Object.freeze({
 	kind: "caption-alignment",
 	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["caption"]), new Set(["audio", "voice"])),
@@ -2200,19 +2480,20 @@ const clipAnchorRelationSpec = Object.freeze({
 	validateEndpoints: (endpoints) => endpoints[0].current().entityKind === "clip" && endpoints[1].current().entityKind === "clip",
 	validateMetadata: isEmptyMetadata
 });
-/** `audio-script-render(output, script)` means endpoint 0 was rendered from endpoint 1. */
-const audioScriptRenderRelationSpec = Object.freeze({
-	kind: "audio-script-render",
-	validateEndpoints: (endpoints) => {
-		const outputKind = endpoints[0].current().entityKind;
-		return (outputKind === "audio" || outputKind === "voice") && endpoints[1].current().entityKind === "audio-script";
-	},
+/** Voice is generated from PhoneticScript; kinds determine roles regardless of endpoint positions. */
+const phoneticScriptRenderRelationSpec = Object.freeze({
+	kind: "phonetic-script-render",
+	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["voice"]), new Set(["phonetic-script"])),
 	validateMetadata: isEmptyMetadata
 });
-/** `audio-script-source(script, source)` means endpoint 0 was transcribed from endpoint 1. */
+/** 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",
+		"video",
+		"voice"
+	])),
 	validateMetadata: isEmptyMetadata
 });
 /**
@@ -2236,11 +2517,9 @@ const builtInRelationSpecs = Object.freeze([
 	markerTimelineRelationSpec,
 	physicalAssetRelationSpec,
 	generatedRelationSpec,
-	phoneticScriptProvenanceRelationSpec,
-	captionProvenanceRelationSpec,
 	captionAlignmentRelationSpec,
 	clipAnchorRelationSpec,
-	audioScriptRenderRelationSpec,
+	phoneticScriptRenderRelationSpec,
 	audioScriptSourceRelationSpec,
 	audioScriptMarkerRelationSpec
 ]);
@@ -2280,9 +2559,6 @@ function isAssetBinding(value) {
 	const orderingKey = /(order|ordinal|position|rank|index|z[_-]?index)/i;
 	return Object.keys(value).every((key) => !orderingKey.test(key));
 }
-function isSegmentAlignmentMetadata(value) {
-	return isJsonObject(value) && Object.hasOwn(value, "segmentAlignment");
-}
 function isCaptionAlignmentMetadata(value) {
 	return isJsonObject(value) && Object.hasOwn(value, "alignment");
 }
@@ -2339,7 +2615,7 @@ var BiRelationIndex = class {
 	byRelationId = /* @__PURE__ */ new Map();
 	link(input) {
 		if (input.spec.kind === "generated") throw new Error("Author generated Relations with linkGenerated({ output, input })");
-		if (input.spec.kind === "clip-anchor" || input.spec.kind === "audio-script-render" || input.spec.kind === "audio-script-source") throw new Error(`Author ordered ${input.spec.kind} Relations with the dedicated role-named method`);
+		if (input.spec.kind === "clip-anchor" || input.spec.kind === "phonetic-script-render" || input.spec.kind === "audio-script-source") throw new Error(`Author ordered ${input.spec.kind} Relations with the dedicated role-named method`);
 		return this.linkValidated(input);
 	}
 	/** Author `generated(output, input)` without exposing positional arguments. */
@@ -2362,12 +2638,12 @@ var BiRelationIndex = class {
 			trace: input.trace
 		});
 	}
-	/** Author `audio-script-render(output, script)` without exposing positional arguments. */
-	linkAudioScriptRender(input) {
+	/** Author `phonetic-script-render(output, phoneticScript)` without exposing positional arguments. */
+	linkPhoneticScriptRender(input) {
 		return this.linkValidated({
 			relationId: input.relationId,
-			spec: audioScriptRenderRelationSpec,
-			endpoints: [input.output, input.script],
+			spec: phoneticScriptRenderRelationSpec,
+			endpoints: [input.output, input.phoneticScript],
 			metadata: {},
 			trace: input.trace
 		});
@@ -2468,7 +2744,13 @@ function decodeEntityRelationRows(rows, options) {
 	const entitiesById = /* @__PURE__ */ new Map();
 	const extensionEntityKinds = new Set(options.entityKinds ?? []);
 	for (const row of rows.entities) {
-		const entity = decodeEntityRow(row, extensionEntityKinds, issues);
+		let entity = decodeEntityRow(row, extensionEntityKinds, issues);
+		if (entity != null) try {
+			entity = decodeEntityRow(assembleEntityContent(rows, row.entityId), extensionEntityKinds, issues);
+		} catch (error) {
+			issues.push(errorMessage(error));
+			continue;
+		}
 		if (entity == null) continue;
 		const ref = createEntityRef(entity);
 		if (entitiesById.has(ref.entityId)) {
@@ -2648,9 +2930,9 @@ var EntityProjectionGraph = class {
 	timeline;
 	constructor(rows) {
 		this.rows = rows;
-		decodeEntityRelationRows(rows, { compareMarkerPoints: (_marker, _range, left, right) => finite(left, "range point") - finite(right, "range point") });
-		this.entities = new Map(rows.entities.map((row) => [String(row.entityId), row]));
-		const roots = rows.entities.filter((row) => row.entityKind === "timeline");
+		const decoded = decodeEntityRelationRows(rows, { compareMarkerPoints: (_marker, _range, left, right) => finite(left, "range point") - finite(right, "range point") });
+		this.entities = new Map([...decoded.entitiesById.values()].map((ref) => [String(ref.entityId), entityToRow(ref.current())]));
+		const roots = [...this.entities.values()].filter((row) => row.entityKind === "timeline");
 		if (roots.length !== 1) fail("compatibility projection requires exactly one Timeline");
 		this.timeline = roots[0];
 	}
@@ -2860,7 +3142,7 @@ function projectEntityTimeline(rows, meta) {
 			const asset = mediaAssetFacts(graph, content);
 			requireUntrimmedAudio(content, marker, placement);
 			const external = externalLocator(asset, "memota-speech");
-			const script = graph.one(content.entityId, "audio-script-render", "audio-script");
+			const assembled = graph.adjacent(content.entityId, "phonetic-script-render").length > 0 || content.payload.voice !== void 0 ? assemblePhoneticScriptContent(rows, graph.one(content.entityId, "phonetic-script-render", "phonetic-script").entityId) : void 0;
 			const voice = content.payload.voice;
 			if (voice !== void 0 && (!object(voice) || voice.system !== "voice-library" || typeof voice.key !== "string")) fail("Voice must use an explicit voice-library locator");
 			const captionIds = layout.tracks.flatMap((candidate) => candidate.role === "caption" ? candidate.clips.filter((caption) => caption.anchorClipEntityId === clip.entityId).map((caption) => caption.clipEntityId) : []);
@@ -2870,7 +3152,7 @@ function projectEntityTimeline(rows, meta) {
 				media_duration_ms: placement.duration,
 				audio_storage_key: storageKey(asset),
 				origin_speech_id: external.key,
-				audio_script: scriptText(script),
+				audio_script: assembled?.text ?? (graph.adjacent(content.entityId, "audio-script-source").length > 0 ? assembleScriptText(graph.one(content.entityId, "audio-script-source", "audio-script")) : ""),
 				volume: volume.data,
 				voice: object(voice) ? {
 					id: typeof voice.key === "string" ? voice.key : void 0,
@@ -2879,12 +3161,7 @@ function projectEntityTimeline(rows, meta) {
 				caption_ids: captionIds
 			} };
 		} else if (track.role === "caption") {
-			const text = content.payload.text;
-			if (typeof text !== "string") fail("Caption " + content.entityId + " requires its text");
-			const asset = graph.one(content.entityId, "physical-asset", "asset");
-			const inline = asset.payload.inline;
-			if (inline !== void 0 && (!object(inline) || inline.mediaType !== "text/plain" || inline.text !== text)) fail("Inline Caption Asset and Caption text must agree");
-			if (inline === void 0 && !object(asset.payload.external)) fail("Caption Asset must identify physical text or contain actual inline text");
+			const text = assembleCaptionContent(rows, content.entityId).text;
 			if (marker.payload.timeRemapping !== void 0) fail("Caption timeRemapping is not supported by this reader");
 			const style = captionStyle(content.payload.style);
 			const anchor = placement.anchorClipEntityId === void 0 ? void 0 : layout.clips.get(placement.anchorClipEntityId);
@@ -2972,14 +3249,6 @@ function storageKey(asset) {
 	if (typeof asset.payload.storageKey !== "string" || asset.payload.storageKey.trim() === "") fail("Asset " + asset.entityId + " requires its factual storageKey");
 	return asset.payload.storageKey;
 }
-function scriptText(script) {
-	const segments = script.payload.segments;
-	if (!Array.isArray(segments)) fail("AudioScript requires segments");
-	return segments.map((segment) => {
-		if (!object(segment) || typeof segment.text !== "string") fail("AudioScript segment requires text");
-		return segment.text;
-	}).join("");
-}
 function captionStyle(value) {
 	if (value === void 0) return void 0;
 	if (!object(value)) fail("Caption style must be an object");
@@ -3351,4 +3620,4 @@ function createPlainMemoryAdapter(document, options) {
 	return new PlainMemoryAdapter(document, options);
 }
 //#endregion
-export { videoDocumentMirrorSchema as $, ensureLaneTrack as A, resolveSpeechOverlapByShiftingVideos as B, toVideoDocument as C, partUnionSchema as D, validateVideoDocument as E, arrangeMainTrackSeamlessly as F, safeDurationMs as G, TIMELINE_SKELETON_DURATION_MS as H, fillMainTrackTimeGaps as I, VIDEO_DOCUMENT_SCHEMA_VERSION as J, DEFAULT_UNIT_TIME_MS as K, reassignSpeechesToVideoClipsByTime as L, laneTrackId as M, solveVideoDocument as N, videoDocumentSchema as O, cascadeAfterVideoClipChanges as P, recordEntries as Q, recalculateTimelineDuration as R, fromVideoDocument as S, assertValidVideoDocument as T, isEmptyVideoClip as U, syncAggregatedClipsTimePosition as V, partDurationMs as W, speedOf as X, effectiveVideoClipDurationMs as Y, partUnionToDraft as Z, hasSequence as _, applyEntityTimelineProjection as a, buildSpeechHostMap as b, writeVideoDocumentToDraft as c, resolveEntityTimelineLayout as d, base64ToBytes as et, EntityTimelineProjectionError as f, createRelationId as g, createEntityId as h, MirrorVideoDocumentAdapter as i, findLaneTrack as j, LANE_KINDS_IN_STACK_ORDER as k, readVideoDocumentFromDraft as l, isJsonObject as m, createPlainMemoryAdapter as n, createMirrorVideoDocument as o, decodeEntityRelationRows as p, ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION as q, generatePartId as r, createMirrorVideoDocumentAdapter as s, PlainMemoryAdapter as t, bytesToBase64 as tt, projectEntityTimeline as u, isMediaAssetVariantKind as v, VideoDocumentValidationError as w, derivePositionFromAbs as x, buildInitialVideoDocument as y, resolveAllSpeechOverlaps as z };
+export { isEmptyVideoClip as $, buildSpeechHostMap as A, ensureLaneTrack as B, variantBaseEntityIds as C, hasSequence as D, createRelationId as E, assertValidVideoDocument as F, arrangeMainTrackSeamlessly as G, laneTrackId as H, validateVideoDocument as I, recalculateTimelineDuration as J, fillMainTrackTimeGaps as K, partUnionSchema as L, fromVideoDocument as M, toVideoDocument as N, isMediaAssetVariantKind as O, VideoDocumentValidationError as P, TIMELINE_SKELETON_DURATION_MS as Q, videoDocumentSchema as R, updateEntityFields as S, createEntityId as T, solveVideoDocument as U, findLaneTrack as V, cascadeAfterVideoClipChanges as W, resolveSpeechOverlapByShiftingVideos as X, resolveAllSpeechOverlaps as Y, syncAggregatedClipsTimePosition as Z, assembleEntityContent as _, applyEntityTimelineProjection as a, effectiveVideoClipDurationMs as at, findComposedAudioScript as b, writeVideoDocumentToDraft as c, recordEntries as ct, EntityProjectionGraph as d, bytesToBase64 as dt, partDurationMs as et, resolveEntityTimelineLayout as f, assembleCaptionContent as g, ScriptCompositionError as h, MirrorVideoDocumentAdapter as i, VIDEO_DOCUMENT_SCHEMA_VERSION as it, derivePositionFromAbs as j, buildInitialVideoDocument as k, readVideoDocumentFromDraft as l, videoDocumentMirrorSchema as lt, decodeEntityRelationRows as m, createPlainMemoryAdapter as n, DEFAULT_UNIT_TIME_MS as nt, createMirrorVideoDocument as o, speedOf as ot, EntityTimelineProjectionError as p, reassignSpeechesToVideoClipsByTime as q, generatePartId as r, ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION as rt, createMirrorVideoDocumentAdapter as s, partUnionToDraft as st, PlainMemoryAdapter as t, safeDurationMs as tt, projectEntityTimeline as u, base64ToBytes as ut, assemblePhoneticScriptContent as v, isJsonObject as w, selectAudioScriptSegments as x, assembleScriptText as y, LANE_KINDS_IN_STACK_ORDER as z };